JIRA REST API参考

JIRA 7.2.1

欢迎来到JIRA REST API参考。 这页文档JIRA可用的REST资源,预计HTTP响应代码和样本请求一起。 您可以使用JIRA的REST API构建使用JIRA的附加 组件 Atlassian的连接 ,开发JIRA和其他应用程序或脚本之间的互动与整合JIRA。

入门

学习JIRA REST API的最好办法是尝试一下。 如果你在云中使用JIRA,Atlassian的连接是构建插件的JIRA一个简单的框架。 尝试在我们JIRA插件教程之一 Atlassian的Connect文档 对于JIRA服务器的JIRA REST API的高度概括,先从 JIRA REST API的家

认证

与JIRA工作的任何身份验证将与REST API工作。 在首选的身份验证方法是OAuth的(例子)和HTTP基本(使用SSL时) ,这是在这两个文件 的JIRA REST API教程 其它支持的方法包括HTTP Cookie和信任的应用程序。

JIRA使用浏览器基于Cookie的身份验证,这样你就可以从Javascript在页面上调用REST和依赖于浏览器已经建立的验证。 以再现的JIRA登录页面的行为(例如,以显示认证错误消息给用户)可以 POST 资源 /auth/1/session

身份验证连接Atlassian的附加

Atlassian的带内置连接JIRA附加组件可以以轻松和一致认证与JIRA API请求,并验证查询参数的完整性使用JWT。 咨询 Atlassian的连接JWT认证文档 ,以了解更多信息。

URI结构

JIRA的REST API的通过URI路径可以访问的资源(数据实体)。 要使用REST API,应用程序将HTTP请求并解析响应。 该JIRA REST API使用 JSON 作为通信格式和标准的HTTP方法,如 GET PUT POST DELETE (请参阅下面的这些方法可用于每个资源API描述)。 对于JIRA的REST API资源的URI的结构如下:

http://host:port/context/rest/api-name/api-version/resource-name

目前有两种可用的API名称,这将在下面进一步讨论的:

  • auth - 用于认证相关的操作,并
  • api - 为一切。

目前的API版本 2 然而,也有一个符号的版本,称为 latest ,解决由给定的JIRA实例所支持的最新版本。 举个例子,如果你想获取问题的JSON表示 JRA-9 从Atlassian的公开问题追踪您就可以访问:

https://jira.atlassian.com/rest/api/latest/issue/JRA-9

有一个 WADL 包含用于JIRA REST API中的每个资源的文档文件。 它可 在这里

扩张

为了简化API响应,JIRA REST API使用资源扩张。 这意味着API只会返回资源的部分明确要求时。

您可以使用 expand 查询参数指定您希望扩展实体的逗号分隔的列表,按名称识别它们。 例如,附加 ?expand=names,renderedFields 到一个问题的URI请求在响应中的翻译的字段名称和HTML呈现字段值的包容。 上面继续我们的例子中,我们可以使用下面的URL来获取信息JRA-9:

https://jira.atlassian.com/rest/api/latest/issue/JRA-9?expand=names,renderedFields

要发现每个实体的标识,看 expand 在父对象的属性。 在下面的JSON例如,资源声明部件为是可扩展的。

{
    "expand": "widgets",
    "self": "http://www.example.com/jira/rest/api/resource/KEY-1",
    "widgets": {
        "widgets": [],
        "size": 5
    }
}

您可以使用点符号到另一个实体中指定的实体扩张。 例如 ?expand=widgets.fringels 将扩大Widgets集合,也是每个插件的fringel财产。

分页

JIRA使用分页限制响应大小返回一个潜在的大集合的项目资源。 一个分页API的请求会导致值数组包裹在一些分页的元数据JSON对象,例如:

    {
        “startAt”:0,
        “的maxResults”:10,
        “总”:200,
        “价值观”:
            {/ *结果0 * /},
            {/ * 1的结果* /},
            {/ * 2的结果* /}
        ]
    }

客户端可以使用“startAt”和“的maxResults”参数来检索结果的所需要的数字。

该“的maxResults”参数表示有多少结果每页返回。 每个API可能对返回的项目数量不同的限制。

的“startAt”参数指示哪些项目应作为在结果中的网页的第一项。

重要的是: 该响应包含“总”的字段,它表示包含在所有页的实体的总数。 这个数字 可能会改变 为客户端请求的后续页。 客户端应该总是假设所请求的页面可以为空。 REST API的消费者也应该考虑外地是可选的。 在情况下,计算这个值的时候太贵了,我们可以不响应包括此。

订购

由某一特定领域的一些资源支持排序。 排序请求是在提供 ORDERBY 查询参数。 请参阅该文档的具体使用方法,看看哪些字段他们支持,如果他们支持订购的。

排序都可以是升序或降序。 默认情况下它的上升。 要指定排序使用“ - ”或“+”号。 例子:

?ORDERBY =名称
由“名”升序
?ORDERBY = +名
由“名”升序
?ORDERBY = -name
由“名”降序排列

实验方法

方法标记为实验可能会更改,恕不较早的通知。 我们正在寻找你对这些方法的反馈。

特殊的请求和响应头

  • 的X AUSERNAME -其中包含验证用户的任一用户名或'匿名'响应头。
  • 的X Atlassian的令牌 -这接受的multipart / form-data的将只与处理请求的方法'X-Atlassian的令牌:不检查'头。

错误响应

大多数资源将除了状态代码返回响应主体。 通常情况下,返回的实体的JSON模式如下:

{
    "id": "https://docs.atlassian.com/jira/REST/schema/error-collection#",
    "title": "Error Collection",
    "type": "object",
    "properties": {
        "errorMessages": {
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "errors": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "status": {
            "type": "integer"
        }
    },
    "additionalProperties": false
}

资源

隐藏所有方法

API / 2 / 隐藏所有方法

提供对当前用户的权限信息。

返回所有的权限在系统中是否当前登录的用户拥有它们。 您可以选择提供特定的上下文来获取权限(projectKey或专案编号或issueKey或issueId)

  • 如果没有上下文提供的项目,如果用户有任何项目许可相关的权限将返回true
  • 如果提供了项目背景下,如果用户在指定的项目的权限项目相关的权限将返回true。 为正在使用的问题的数据(例如当前代理人)确定的权限,真会如果用户满足许可条件中的任何问题在于项目返回
  • 如果提供了问题的背景下,它会返回用户是否有该特定问题的每个权限

注:以上意味着问题级别权限(EDIT_ISSUE为例),hasPermission没有提供上下文时可能是真实的,或者提供一个项目上下文时, 可能是任何给定的(或全部)出具虚假。 如果记者分别给予EDIT_ISSUE许可,这将发生(例如)。 这是因为,任何用户可以是一个记者,除了在一个具体的问题,其中所述记者已知的情况下。

全局权限仍然会返回所有范围。

此前版本6.4服务返回的项目权限对应于com.atlassian.jira.security.Permissions.Permission常数项。 由于这些6.4密钥被认为已过时,并对应于com.atlassian.jira.permission.ProjectPermissions定义的常量该服务回报系统项目的许可密钥。 与传统钥匙的权限也还是返回向后兼容性,它们都标有一个属性deprecatedKey = TRUE。 属性缺少与当前键项目的权限。

请求
查询参数
参数 类型 描述
projectKey

- 项目范围的关键返回权限。

projectId

- 项目范围ID返回权限。

issueKey

- 该问题的范围主要返回权限。

issueId

- 该问题范围ID返回权限。

回复
  • 状态200 - 应用程序/ JSON
    返回JIRA以及用户是否拥有所有这些权限的列表。
    {
        "permissions": {
            "EDIT_ISSUE": {
                "id": "12",
                "key": "EDIT_ISSUES",
                "name": "Edit Issues",
                "type": "PROJECT",
                "description": "Ability to edit issues.",
                "havePermission": true
            }
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/permissions#",
        "title": "Permissions",
        "type": "object",
        "properties": {
            "permissions": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Permission",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "key": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "type": {
                                "type": "string",
                                "enum": [
                                    "GLOBAL",
                                    "PROJECT"
                                ]
                            },
                            "description": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果项目或问题ID无效。
  • 状态404
    如果找不到该项目或问题ID或键返回。

返回出现在JIRA实例中的所有权限 - 通过插件添加全球,项目和全局对象

回复
  • 状态200 - 应用程序/ JSON
    返回JIRA所有权限的列表。
    {
        "permissions": {
            "BULK_CHANGE": {
                "key": "BULK_CHANGE",
                "name": "Bulk Change",
                "type": "GLOBAL",
                "description": "Ability to modify a collection of issues at once. For example, resolve multiple issues in one step."
            }
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/permissions#",
        "title": "Permissions",
        "type": "object",
        "properties": {
            "permissions": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Permission",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "key": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "type": {
                                "type": "string",
                                "enum": [
                                    "GLOBAL",
                                    "PROJECT"
                                ]
                            },
                            "description": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回未经授权的请求
  • 状态403
    返回用户无需管理权限

API / 2 /应用程序的属性隐藏所有方法

返回一个应用程序属性。

请求
查询参数
参数 类型 描述
key

包含属性值的字符串

permissionLevel

当读取一个列表指定列表中的所有项目的权限级别见{@link com.atlassian.jira.bc.admin.ApplicationPropertiesService.EditPermissionLevel}

keyFilter

当获取列表允许通过按键如财产的启动被过滤列表中的“jira.lf. *”取对子级只可编辑,其键开始“jira.lf.”这些权限。 这是一个正则表达式。

回复
  • 状态200 - 应用程序/ JSON
    如果属性存在返回,目前已验证的用户有权限查看。 包含属性的完整的表示。
    [
        {
            "id": "jira.home",
            "key": "jira.home",
            "value": "/var/jira/jira-home",
            "name": "jira.home",
            "desc": "JIRA home directory",
            "type": "string",
            "defaultValue": ""
        },
        {
            "id": "jira.clone.prefix",
            "key": "jira.clone.prefix",
            "value": "CLONE -",
            "name": "The prefix added to the Summary field of cloned issues",
            "type": "string",
            "defaultValue": "CLONE -"
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/property#",
        "title": "Property",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "key": {
                "type": "string"
            },
            "value": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "desc": {
                "type": "string"
            },
            "type": {
                "type": "string"
            },
            "defaultValue": {
                "type": "string"
            },
            "example": {
                "type": "string"
            },
            "allowedValues": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果属性不存在,或当前身份验证的用户没有权限查看它返回。

通过PUT修改应用程序属性。 “价值”字段存在于PUT将覆盖现有的值。

请求
{
    "id": "jira.home",
    "value": "/var/jira/jira-home"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/application-property#",
    "title": "Application Property",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "value": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    如果属性存在返回,目前已验证的用户有权对其进行编辑。
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/property#",
        "title": "Property",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "key": {
                "type": "string"
            },
            "value": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "desc": {
                "type": "string"
            },
            "type": {
                "type": "string"
            },
            "defaultValue": {
                "type": "string"
            },
            "example": {
                "type": "string"
            },
            "allowedValues": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            }
        },
        "additionalProperties": false
    }
  • 状态403
    返回如果当前身份验证的用户没有权限编辑属性。
  • 状态404
    如果属性不存在,或当前身份验证的用户没有权限查看它返回。

返回时所显示的“常规配置>高级设置”页面上的属性。

回复
  • 状态200 - 应用程序/ JSON
    返回所有的属性,在“常规配置>高级设置”页面中显示。
    [
        {
            "id": "jira.home",
            "key": "jira.home",
            "value": "/var/jira/jira-home",
            "name": "jira.home",
            "desc": "JIRA home directory",
            "type": "string",
            "defaultValue": ""
        },
        {
            "id": "jira.clone.prefix",
            "key": "jira.clone.prefix",
            "value": "CLONE -",
            "name": "The prefix added to the Summary field of cloned issues",
            "type": "string",
            "defaultValue": "CLONE -"
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-property#",
        "title": "List of Property",
        "type": "array",
        "items": {
            "title": "Property",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "key": {
                    "type": "string"
                },
                "value": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "desc": {
                    "type": "string"
                },
                "type": {
                    "type": "string"
                },
                "defaultValue": {
                    "type": "string"
                },
                "example": {
                    "type": "string"
                },
                "allowedValues": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                }
            },
            "additionalProperties": false
        }
    }
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态403
    返回如果当前用户不是管理员。

API / 2 / applicationrole 隐藏所有方法

提供对JIRA的应用程序角色REST访问。

返回系统中的所有ApplicationRoles。 也将返回一个包含ApplicationRoles集合的一个版本散列ETag头。

回复
  • 状态200 - 应用程序/ JSON
    返回所有ApplicationRoles系统
    [
        {
            "key": "jira-software",
            "groups": [
                "jira-software-users",
                "jira-testers"
            ],
            "name": "JIRA Software",
            "defaultGroups": [
                "jira-software-users"
            ],
            "selectedByDefault": false,
            "defined": false,
            "numberOfSeats": 10,
            "remainingSeats": 5,
            "userCount": 5,
            "userCountDescription": "5 developers",
            "hasUnlimitedSeats": false,
            "platform": false
        },
        {
            "key": "jira-core",
            "groups": [
                "jira-core-users"
            ],
            "name": "JIRA Core",
            "defaultGroups": [
                "jira-core-users"
            ],
            "selectedByDefault": false,
            "defined": false,
            "numberOfSeats": 1,
            "remainingSeats": 1,
            "userCount": 0,
            "userCountDescription": "0 users",
            "hasUnlimitedSeats": false,
            "platform": true
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-application-role#",
        "title": "List of Application Role",
        "type": "array",
        "items": {
            "title": "Application Role",
            "type": "object",
            "properties": {
                "key": {
                    "type": "string"
                },
                "groups": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "name": {
                    "type": "string"
                },
                "defaultGroups": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "selectedByDefault": {
                    "type": "boolean"
                },
                "defined": {
                    "type": "boolean"
                },
                "numberOfSeats": {
                    "type": "integer"
                },
                "remainingSeats": {
                    "type": "integer"
                },
                "userCount": {
                    "type": "integer"
                },
                "userCountDescription": {
                    "type": "string"
                },
                "hasUnlimitedSeats": {
                    "type": "boolean"
                },
                "platform": {
                    "type": "boolean"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态403
    返回如果当前用户不是管理员。

更新与传递数据的ApplicationRoles如果版本散列是相同的服务器。 只有组和默认组角色的设定可能会更新。 请求更改密钥或角色的名称将被忽略。 可以接受的是通过仅被更新为存在于服务器,但不是在数据与更新,也不会被删除的角色的角色。

请求
头参数
参数 类型 描述
If-Match
{
    "key": "jira-software",
    "groups": [
        "jira-software-users",
        "jira-testers"
    ],
    "name": "JIRA Software",
    "defaultGroups": [
        "jira-software-users"
    ],
    "selectedByDefault": true
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/list-of-application-role#",
    "title": "List of Application Role",
    "type": "array",
    "items": {
        "title": "Application Role",
        "type": "object",
        "properties": {
            "key": {
                "type": "string"
            },
            "groups": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "name": {
                "type": "string"
            },
            "defaultGroups": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "selectedByDefault": {
                "type": "boolean"
            },
            "defined": {
                "type": "boolean"
            },
            "numberOfSeats": {
                "type": "integer"
            },
            "remainingSeats": {
                "type": "integer"
            },
            "userCount": {
                "type": "integer"
            },
            "userCountDescription": {
                "type": "string"
            },
            "hasUnlimitedSeats": {
                "type": "boolean"
            },
            "platform": {
                "type": "boolean"
            }
        },
        "additionalProperties": false
    }
}
回复
  • 状态200 - 应用程序/ JSON
    返回更新ApplicationRole如果更新成功。
    [
        {
            "key": "jira-software",
            "groups": [
                "jira-software-users",
                "jira-testers"
            ],
            "name": "JIRA Software",
            "defaultGroups": [
                "jira-software-users"
            ],
            "selectedByDefault": false,
            "defined": false,
            "numberOfSeats": 10,
            "remainingSeats": 5,
            "userCount": 5,
            "userCountDescription": "5 developers",
            "hasUnlimitedSeats": false,
            "platform": false
        },
        {
            "key": "jira-core",
            "groups": [
                "jira-core-users"
            ],
            "name": "JIRA Core",
            "defaultGroups": [
                "jira-core-users"
            ],
            "selectedByDefault": false,
            "defined": false,
            "numberOfSeats": 1,
            "remainingSeats": 1,
            "userCount": 0,
            "userCountDescription": "0 users",
            "hasUnlimitedSeats": false,
            "platform": true
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-application-role#",
        "title": "List of Application Role",
        "type": "array",
        "items": {
            "title": "Application Role",
            "type": "object",
            "properties": {
                "key": {
                    "type": "string"
                },
                "groups": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "name": {
                    "type": "string"
                },
                "defaultGroups": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "selectedByDefault": {
                    "type": "boolean"
                },
                "defined": {
                    "type": "boolean"
                },
                "numberOfSeats": {
                    "type": "integer"
                },
                "remainingSeats": {
                    "type": "integer"
                },
                "userCount": {
                    "type": "integer"
                },
                "userCountDescription": {
                    "type": "string"
                },
                "hasUnlimitedSeats": {
                    "type": "boolean"
                },
                "platform": {
                    "type": "boolean"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态401
    返回如果当前用户没有权限进行编辑的角色。
  • 状态412
    如果IF-Match头不为空并且包含不同版本的服务器返回。
  • 状态403
    返回如果当前用户不是管理员。
  • 状态404
    如果角色不存在返回。

返回ApplicationRole与如果存在通过关键。

回复
  • 状态200 - 应用程序/ JSON
    如果存在返回ApplicationRole。
    {
        "key": "jira-software",
        "groups": [
            "jira-software-users",
            "jira-testers"
        ],
        "name": "JIRA Software",
        "defaultGroups": [
            "jira-software-users"
        ],
        "selectedByDefault": false,
        "defined": false,
        "numberOfSeats": 10,
        "remainingSeats": 5,
        "userCount": 5,
        "userCountDescription": "5 developers",
        "hasUnlimitedSeats": false,
        "platform": false
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/application-role#",
        "title": "Application Role",
        "type": "object",
        "properties": {
            "key": {
                "type": "string"
            },
            "groups": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "name": {
                "type": "string"
            },
            "defaultGroups": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "selectedByDefault": {
                "type": "boolean"
            },
            "defined": {
                "type": "boolean"
            },
            "numberOfSeats": {
                "type": "integer"
            },
            "remainingSeats": {
                "type": "integer"
            },
            "userCount": {
                "type": "integer"
            },
            "userCountDescription": {
                "type": "string"
            },
            "hasUnlimitedSeats": {
                "type": "boolean"
            },
            "platform": {
                "type": "boolean"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态403
    返回如果当前用户不是管理员。
  • 状态404
    如果角色不存在返回。

更新ApplicationRole与传递的数据。 只有组和默认组角色的设定可能会更新。 请求更改密钥或角色的名称将被忽略。

可选:如果versionHash通过IF-通过匹配的头请求将被拒绝,如果不一样的服务器

请求
头参数
参数 类型 描述
If-Match

的版本的散列来更新。 可选参数

{
    "key": "jira-software",
    "groups": [
        "jira-software-users",
        "jira-testers"
    ],
    "name": "JIRA Software",
    "defaultGroups": [
        "jira-software-users"
    ],
    "selectedByDefault": true
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/application-role#",
    "title": "Application Role",
    "type": "object",
    "properties": {
        "key": {
            "type": "string"
        },
        "groups": {
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "name": {
            "type": "string"
        },
        "defaultGroups": {
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "selectedByDefault": {
            "type": "boolean"
        },
        "defined": {
            "type": "boolean"
        },
        "numberOfSeats": {
            "type": "integer"
        },
        "remainingSeats": {
            "type": "integer"
        },
        "userCount": {
            "type": "integer"
        },
        "userCountDescription": {
            "type": "string"
        },
        "hasUnlimitedSeats": {
            "type": "boolean"
        },
        "platform": {
            "type": "boolean"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    返回更新ApplicationRole如果更新成功。
    {
        "key": "jira-software",
        "groups": [
            "jira-software-users",
            "jira-testers"
        ],
        "name": "JIRA Software",
        "defaultGroups": [
            "jira-software-users"
        ],
        "selectedByDefault": false,
        "defined": false,
        "numberOfSeats": 10,
        "remainingSeats": 5,
        "userCount": 5,
        "userCountDescription": "5 developers",
        "hasUnlimitedSeats": false,
        "platform": false
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/application-role#",
        "title": "Application Role",
        "type": "object",
        "properties": {
            "key": {
                "type": "string"
            },
            "groups": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "name": {
                "type": "string"
            },
            "defaultGroups": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "selectedByDefault": {
                "type": "boolean"
            },
            "defined": {
                "type": "boolean"
            },
            "numberOfSeats": {
                "type": "integer"
            },
            "remainingSeats": {
                "type": "integer"
            },
            "userCount": {
                "type": "integer"
            },
            "userCountDescription": {
                "type": "string"
            },
            "hasUnlimitedSeats": {
                "type": "boolean"
            },
            "platform": {
                "type": "boolean"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果当前用户没有权限进行编辑的角色。
  • 状态412
    如果IF-Match头不为空并且包含不同版本的服务器返回。
  • 状态403
    返回如果当前用户不是管理员。
  • 状态404
    如果角色不存在返回。

API / 2 /附件隐藏所有方法

返回一个附件,包括实际附加的文件的URI的元数据。

回复
  • 状态200 - 应用程序/ JSON
    附着的元数据的JSON表示。 表示不包含附件本身,但包含的URI可用于下载实际的附加文件。
    {
        "self": "http://www.example.com/jira/rest/api/2.0/attachments/10000",
        "filename": "picture.jpg",
        "author": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "created": "2016-09-06T09:48:12.753+0000",
        "size": 23123,
        "mimeType": "image/jpeg",
        "content": "http://www.example.com/jira/attachments/10000",
        "thumbnail": "http://www.example.com/jira/secure/thumbnail/10000"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/attachment#",
        "title": "Attachment",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "filename": {
                "type": "string"
            },
            "author": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "created": {
                "type": "string"
            },
            "size": {
                "type": "integer"
            },
            "mimeType": {
                "type": "string"
            },
            "properties": {
                "type": "object",
                "patternProperties": {
                    ".+": {}
                },
                "additionalProperties": false
            },
            "content": {
                "type": "string"
            },
            "thumbnail": {
                "type": "string"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "size"
        ]
    }
  • 状态403
    主叫用户不允许查看所请求的附件。
  • 状态404
    任何:
    • 有与所请求的id的附件
    • 附件功能被禁用

取下一个问题的附件。

回复
  • 状态204
    删除成功
  • 状态403
    主叫用户不允许移除请求的附件。
  • 状态404
    任何:
    • 有与所请求的id的附件
    • 附件功能被禁用

努力扩大附件。 输出为人类可读,并随时可能更改。

回复
  • 状态200 - 应用程序/ JSON
    的附件展开的内容JSON表示。 空的参赛名单意味着,附件无法进行扩展。 这是不是空的,损坏或没有存档的。
    {
        "id": 7237823,
        "name": "images.zip",
        "entries": [
            {
                "path": "MG00N067.JPG",
                "index": 0,
                "size": "119 kB",
                "mediaType": "image/jpeg",
                "label": "MG00N067.JPG"
            },
            {
                "path": "Allegro from Duet in C Major.mp3",
                "index": 1,
                "size": "1.36 MB",
                "mediaType": "audio/mpeg",
                "label": "Allegro from Duet in C Major.mp3"
            },
            {
                "path": "long/path/thanks/to/lots/of/subdirectories/inside/making/it/quite/hard/to/reach/the/leaf.txt",
                "index": 2,
                "size": "0.0 k",
                "mediaType": "text/plain",
                "label": "long/path/thanks/to/.../reach/the/leaf.txt"
            }
        ],
        "totalEntryCount": 39,
        "mediaType": "application/zip"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/human-readable-archive#",
        "title": "Human Readable Archive",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "entries": {
                "type": "array",
                "items": {
                    "title": "Human Readable Archive Entry",
                    "type": "object",
                    "properties": {
                        "path": {
                            "type": "string"
                        },
                        "index": {
                            "type": "integer"
                        },
                        "size": {
                            "type": "string"
                        },
                        "mediaType": {
                            "type": "string"
                        },
                        "label": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "index"
                    ]
                }
            },
            "totalEntryCount": {
                "type": "integer"
            },
            "mediaType": {
                "type": "string"
            }
        },
        "additionalProperties": false,
        "required": [
            "id",
            "totalEntryCount"
        ]
    }
  • 状态403
    主叫用户不允许查看所请求的附件。
  • 状态404
    任何:
    • 有与所请求的id的附件
    • 附件功能被禁用
  • 状态409
    不支持的压缩格式。

努力扩大附件。 输出为原应通过日久向后兼容。

回复
  • 状态200 - 应用程序/ JSON
    的附件展开的内容JSON表示。 空的参赛名单意味着,附件无法进行扩展。 这是不是空的,损坏或没有存档的。
    {
        "entries": [
            {
                "entryIndex": 0,
                "name": "Allegro from Duet in C Major.mp3",
                "size": 1430174,
                "mediaType": "audio/mpeg"
            },
            {
                "entryIndex": 1,
                "name": "lrm.rtf",
                "size": 331,
                "mediaType": "text/rtf"
            }
        ],
        "totalEntryCount": 24
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/attachment-archive-impl#",
        "title": "Attachment Archive Impl",
        "type": "object",
        "properties": {
            "entries": {
                "type": "array",
                "items": {
                    "title": "Attachment Archive Entry",
                    "type": "object",
                    "properties": {
                        "abbreviatedName": {
                            "type": "string"
                        },
                        "entryIndex": {
                            "type": "integer"
                        },
                        "mediaType": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "size": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "entryIndex",
                        "size"
                    ]
                }
            },
            "totalEntryCount": {
                "type": "integer"
            }
        },
        "additionalProperties": false,
        "required": [
            "totalEntryCount"
        ]
    }
  • 状态403
    主叫用户不允许查看所请求的附件。
  • 状态404
    任何:
    • 有与所请求的id的附件
    • 附件功能被禁用
  • 状态409
    不支持的压缩格式。

返回一个附件的元信息,特别是如果它们被启用,允许的最大上传大小。

回复
  • 状态200 - 应用程序/ JSON
    的附着能力JSON表示。 这种资源的消费者可能还需要检查,如果登录的用户有权上传或以其它方式使用{@link com.atlassian.jira.rest.v2.permission.PermissionsResource}操纵附件。
    {
        "enabled": true,
        "uploadLimit": 1000000
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/attachment-meta#",
        "title": "Attachment Meta",
        "type": "object",
        "properties": {
            "enabled": {
                "type": "boolean"
            },
            "uploadLimit": {
                "type": "integer"
            }
        },
        "additionalProperties": false,
        "required": [
            "enabled"
        ]
    }

API / 2 /审计隐藏所有方法

资源占审计记录

返回使用提供的参数过滤审计记录

请求
查询参数
参数 类型 描述
offset INT

- 从搜索开始记录的数

limit INT

- 返回结果的最大数量(如果限制为<= 0或> 1000,它将被设置做默认值:1000)

filter

- 文本查询; 将返回的每个记录都必须包含在其字段之一所提供的文本

from

- 时间戳过去; “从”必须小于或等于'到',否则结果集将为空只记载,凡在同一时刻或“从”时间戳后创建的响应提供

to

- 时间戳过去; “从”必须小于或等于'到',否则结果集将为空只记载,凡在同一时刻或创建早于“到”时间戳响应提供

回复
  • 状态200 - 应用程序/ JSON
    返回与请求的查询参数过滤列表审计记录
    {
        "id": 1,
        "summary": "User created",
        "remoteAddress": "192.168.1.1",
        "authorKey": "administrator",
        "created": "2014-03-19T18:45:42.967+0000",
        "category": "user management",
        "eventSource": "JIRA Connect Plugin",
        "description": "Optional description",
        "objectItem": {
            "id": "user",
            "name": "user",
            "typeName": "USER",
            "parentId": "1",
            "parentName": "JIRA Internal Directory"
        },
        "changedValues": [
            {
                "fieldName": "email",
                "changedFrom": "user@atlassian.com",
                "changedTo": "newuser@atlassian.com"
            }
        ],
        "associatedItems": [
            {
                "id": "jira-software-users",
                "name": "jira-software-users",
                "typeName": "GROUP",
                "parentId": "1",
                "parentName": "JIRA Internal Directory"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/audit-record#",
        "title": "Audit Record",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "summary": {
                "type": "string"
            },
            "remoteAddress": {
                "type": "string"
            },
            "authorKey": {
                "type": "string"
            },
            "created": {
                "type": "string"
            },
            "category": {
                "type": "string"
            },
            "eventSource": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "objectItem": {
                "$ref": "#/definitions/associated-item"
            },
            "changedValues": {
                "type": "array",
                "items": {
                    "title": "Changed Value",
                    "type": "object",
                    "properties": {
                        "fieldName": {
                            "type": "string"
                        },
                        "changedFrom": {
                            "type": "string"
                        },
                        "changedTo": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "associatedItems": {
                "type": "array",
                "items": {
                    "$ref": "#/definitions/associated-item"
                }
            }
        },
        "definitions": {
            "associated-item": {
                "title": "Associated Item",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "typeName": {
                        "type": "string"
                    },
                    "parentId": {
                        "type": "string"
                    },
                    "parentName": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态400
    在未处理的错误时,同时取审计记录
  • 状态403
    如果用户没有管理权限返回

存放在审计日志记录

请求
{
    "summary": "User created",
    "created": null,
    "category": "USER_MANAGEMENT",
    "objectItem": {
        "id": "usr",
        "name": "user",
        "typeName": "USER",
        "parentId": "1",
        "parentName": "JIRA Internal Directory"
    },
    "changedValues": [
        {
            "fieldName": "email",
            "changedFrom": "user@atlassian.com",
            "changedTo": "newuser@atlassian.com"
        }
    ],
    "associatedItems": [
        {
            "id": "jira-software-users",
            "name": "jira-software-users",
            "typeName": "GROUP",
            "parentId": "1",
            "parentName": "JIRA Internal Directory"
        }
    ]
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/audit-record#",
    "title": "Audit Record",
    "type": "object",
    "properties": {
        "id": {
            "type": "integer"
        },
        "summary": {
            "type": "string"
        },
        "remoteAddress": {
            "type": "string"
        },
        "authorKey": {
            "type": "string"
        },
        "created": {
            "type": "string"
        },
        "category": {
            "type": "string"
        },
        "eventSource": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "objectItem": {
            "$ref": "#/definitions/associated-item"
        },
        "changedValues": {
            "type": "array",
            "items": {
                "title": "Changed Value",
                "type": "object",
                "properties": {
                    "fieldName": {
                        "type": "string"
                    },
                    "changedFrom": {
                        "type": "string"
                    },
                    "changedTo": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            }
        },
        "associatedItems": {
            "type": "array",
            "items": {
                "$ref": "#/definitions/associated-item"
            }
        }
    },
    "definitions": {
        "associated-item": {
            "title": "Associated Item",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "typeName": {
                    "type": "string"
                },
                "parentId": {
                    "type": "string"
                },
                "parentName": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    },
    "additionalProperties": false
}
回复
  • 状态201
    返回如果记录成功存储。
  • 状态400
    在未处理的错误时,同时取审计记录
  • 状态403
    如果用户没有管理权限返回

API / 2 /头像隐藏所有方法

返回给定类型的所有系统的化身。

回复
  • 状态200 - 应用程序/ JSON
    返回包含系统替身列表的图。 的地图返回到与项目/ KEY /替身REST结束点的形状是一致的。
    {
        "system": [
            {
                "id": "1000",
                "owner": "fred",
                "isSystemAvatar": true,
                "isSelected": false,
                "isDeletable": false,
                "urls": {
                    "16x16": "http://localhost:8090/jira/secure/useravatar?size=xsmall&avatarId=10040",
                    "24x24": "http://localhost:8090/jira/secure/useravatar?size=small&avatarId=10040",
                    "32x32": "http://localhost:8090/jira/secure/useravatar?size=medium&avatarId=10040",
                    "48x48": "http://localhost:8090/jira/secure/useravatar?avatarId=10040"
                },
                "selected": false
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/system-avatars#",
        "title": "System Avatars",
        "type": "object",
        "properties": {
            "system": {
                "type": "array",
                "items": {
                    "title": "Avatar",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "owner": {
                            "type": "string"
                        },
                        "isSystemAvatar": {
                            "type": "boolean"
                        },
                        "isSelected": {
                            "type": "boolean"
                        },
                        "isDeletable": {
                            "type": "boolean"
                        },
                        "urls": {
                            "type": "object",
                            "patternProperties": {
                                "\\d\\dx\\d\\d": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        },
                        "selected": {
                            "type": "boolean"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "isSystemAvatar",
                        "isSelected",
                        "isDeletable",
                        "selected"
                    ]
                }
            }
        },
        "additionalProperties": false
    }
  • 状态500
    如果返回在检索化身的列表时发生错误。

创建临时头像

请求
查询参数
参数 类型 描述
filename

文件的名称被上传

size

文件大小

回复
  • 状态201 - 应用程序/ JSON
    临时头像裁剪说明
    {
        "cropperWidth": 120,
        "cropperOffsetX": 50,
        "cropperOffsetY": 50,
        "url": "http://example.com/jira/secure/temporaryavatar?cropped=true",
        "needsCropping": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
        "title": "Avatar Cropping",
        "type": "object",
        "properties": {
            "cropperWidth": {
                "type": "integer"
            },
            "cropperOffsetX": {
                "type": "integer"
            },
            "cropperOffsetY": {
                "type": "integer"
            },
            "url": {
                "type": "string"
            },
            "needsCropping": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "cropperWidth",
            "cropperOffsetX",
            "cropperOffsetY",
            "needsCropping"
        ]
    }
  • 状态400
    Valiation失败。 例如文件大小超出最大附件大小。
  • 状态500
    返回如果在临时化身转换为真正的化身出现错误
  • 状态403
    如果该请求不conain有效XSRF令牌返回

更新临时化身的种植指导。

请求
{
    "cropperWidth": 120,
    "cropperOffsetX": 50,
    "cropperOffsetY": 50,
    "needsCropping": false
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
    "title": "Avatar Cropping",
    "type": "object",
    "properties": {
        "cropperWidth": {
            "type": "integer"
        },
        "cropperOffsetX": {
            "type": "integer"
        },
        "cropperOffsetY": {
            "type": "integer"
        },
        "url": {
            "type": "string"
        },
        "needsCropping": {
            "type": "boolean"
        }
    },
    "additionalProperties": false,
    "required": [
        "cropperWidth",
        "cropperOffsetX",
        "cropperOffsetY",
        "needsCropping"
    ]
}
回复
  • 状态201 - 应用程序/ JSON
  • 状态400
    返回如果裁剪坐标无效
  • 状态500
    如果返回裁剪过程中临时化身出现错误

API / 2 /评论/ {} commentId /属性隐藏所有方法

返回由键或用id标识注释的所有属性的钥匙。

回复
  • 状态200 - 应用程序/ JSON
    如果注释被发现返回。
    {
        "keys": [
            {
                "self": "http://www.example.com/jira/rest/api/2/issue/EX-2/properties/issue.support",
                "key": "issue.support"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-properties-keys#",
        "title": "Entity Properties Keys",
        "type": "object",
        "properties": {
            "keys": {
                "type": "array",
                "items": {
                    "title": "Entity Property Key",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "key": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果注释键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    如果返回调用用户没有权限浏览评论。
  • 状态404
    如果返回与给定的密钥或ID的评论不存在,或者给定键的属性是找不到的。

移除的键或用id标识注释的属性。 THS用户删除属性是需要有权限管理评论。

回复
  • 状态400
    返回如果注释键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态204
    返回是否成功删除注释属性。
  • 状态403
    如果返回调用用户没有权限编辑评论。
  • 状态404
    如果返回与给定的密钥或ID的评论不存在,或者给定键的属性是找不到的。

设置指定注释的属性的值。

你可以使用这个资源来存储反对键或用id标识的注释自定义数据。 谁存储数据的用户需要具有的权限来管理评论。

回复
  • 状态200
    返回如果评论属性成功更新。
  • 状态201
    如果成功创建注释属性返回。
  • 状态400
    返回如果注释键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    如果返回调用用户没有权限管理评论。
  • 状态404
    如果与给定的密钥或ID的评论不存在返回。

返回由键或由id标识的评论给定键的属性的值。 谁检索的属性的用户需要有权限读取的注释。

回复
  • 状态200 - 应用程序/ JSON
    如果注释财产被发现返回。
    {
        "key": "issue.support",
        "value": {
            "hipchat.room.id": "support-123",
            "support.time": "1m"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-property#",
        "title": "Entity Property",
        "type": "object",
        "properties": {
            "key": {
                "type": "string"
            },
            "value": {}
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果注释键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    如果返回调用用户没有权限浏览评论。
  • 状态404
    如果返回与给定的密钥或ID的评论不存在,或者给定键的属性是找不到的。

API / 2 /组件隐藏所有方法

通过创建一个POST组件。

请求
{
    "name": "Component 1",
    "description": "This is a JIRA component",
    "leadUserName": "fred",
    "assigneeType": "PROJECT_LEAD",
    "isAssigneeTypeValid": false,
    "project": "PROJECTKEY",
    "projectId": 10000
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/component#",
    "title": "Component",
    "type": "object",
    "properties": {
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "lead": {
            "$ref": "#/definitions/user"
        },
        "leadUserName": {
            "type": "string"
        },
        "assigneeType": {
            "type": "string",
            "enum": [
                "PROJECT_DEFAULT",
                "COMPONENT_LEAD",
                "PROJECT_LEAD",
                "UNASSIGNED"
            ]
        },
        "assignee": {
            "$ref": "#/definitions/user"
        },
        "realAssigneeType": {
            "type": "string",
            "enum": [
                "PROJECT_DEFAULT",
                "COMPONENT_LEAD",
                "PROJECT_LEAD",
                "UNASSIGNED"
            ]
        },
        "realAssignee": {
            "$ref": "#/definitions/user"
        },
        "isAssigneeTypeValid": {
            "type": "boolean"
        },
        "project": {
            "type": "string"
        },
        "projectId": {
            "type": "integer"
        }
    },
    "definitions": {
        "simple-list-wrapper": {
            "title": "Simple List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "title": "Group",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size"
            ]
        },
        "user": {
            "title": "User",
            "type": "object",
            "properties": {
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        }
    },
    "additionalProperties": false,
    "required": [
        "isAssigneeTypeValid"
    ]
}
回复
  • 状态201 - 应用程序/ JSON
    如果组件创建成功返回。
    {
        "self": "http://www.example.com/jira/rest/api/2/component/10000",
        "id": "10000",
        "name": "Component 1",
        "description": "This is a JIRA component",
        "lead": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "assigneeType": "PROJECT_LEAD",
        "assignee": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "realAssigneeType": "PROJECT_LEAD",
        "realAssignee": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "isAssigneeTypeValid": false,
        "project": "HSP",
        "projectId": 10000
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/component#",
        "title": "Component",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "lead": {
                "$ref": "#/definitions/user"
            },
            "leadUserName": {
                "type": "string"
            },
            "assigneeType": {
                "type": "string",
                "enum": [
                    "PROJECT_DEFAULT",
                    "COMPONENT_LEAD",
                    "PROJECT_LEAD",
                    "UNASSIGNED"
                ]
            },
            "assignee": {
                "$ref": "#/definitions/user"
            },
            "realAssigneeType": {
                "type": "string",
                "enum": [
                    "PROJECT_DEFAULT",
                    "COMPONENT_LEAD",
                    "PROJECT_LEAD",
                    "UNASSIGNED"
                ]
            },
            "realAssignee": {
                "$ref": "#/definitions/user"
            },
            "isAssigneeTypeValid": {
                "type": "boolean"
            },
            "project": {
                "type": "string"
            },
            "projectId": {
                "type": "integer"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "isAssigneeTypeValid"
        ]
    }
  • 状态401
    如果调用者没有登录,并没有权限在项目中创建组件返回。
  • 状态403
    返回如果调用者进行身份验证并没有权限在项目中创建组件。
  • 状态404
    如果该项目不存在,或当前身份验证的用户没有权限查看它返回。

返回一个项目的组成部分。

回复
  • 状态200 - 应用程序/ JSON
    返回一个项目的组成一个完整的JSON表示。
    {
        "self": "http://www.example.com/jira/rest/api/2/component/10000",
        "id": "10000",
        "name": "Component 1",
        "description": "This is a JIRA component",
        "lead": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "assigneeType": "PROJECT_LEAD",
        "assignee": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "realAssigneeType": "PROJECT_LEAD",
        "realAssignee": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "isAssigneeTypeValid": false,
        "project": "HSP",
        "projectId": 10000
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/component#",
        "title": "Component",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "lead": {
                "$ref": "#/definitions/user"
            },
            "leadUserName": {
                "type": "string"
            },
            "assigneeType": {
                "type": "string",
                "enum": [
                    "PROJECT_DEFAULT",
                    "COMPONENT_LEAD",
                    "PROJECT_LEAD",
                    "UNASSIGNED"
                ]
            },
            "assignee": {
                "$ref": "#/definitions/user"
            },
            "realAssigneeType": {
                "type": "string",
                "enum": [
                    "PROJECT_DEFAULT",
                    "COMPONENT_LEAD",
                    "PROJECT_LEAD",
                    "UNASSIGNED"
                ]
            },
            "realAssignee": {
                "$ref": "#/definitions/user"
            },
            "isAssigneeTypeValid": {
                "type": "boolean"
            },
            "project": {
                "type": "string"
            },
            "projectId": {
                "type": "integer"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "isAssigneeTypeValid"
        ]
    }
  • 状态404
    返回如果存在与给定键的部件,或者如果调用用户不具有权限浏览的组件。

通过PUT修改组件。 目前在把任何领域将覆盖现有值。 为方便起见,如果一个字段不存在,它被忽略。

如果leadUserName是一个空字符串(“”)的元件引线将被删除。

请求
{
    "name": "Component 1",
    "description": "This is a JIRA component",
    "leadUserName": "fred",
    "assigneeType": "PROJECT_LEAD",
    "isAssigneeTypeValid": false,
    "project": "PROJECTKEY",
    "projectId": 10000
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/component#",
    "title": "Component",
    "type": "object",
    "properties": {
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "lead": {
            "$ref": "#/definitions/user"
        },
        "leadUserName": {
            "type": "string"
        },
        "assigneeType": {
            "type": "string",
            "enum": [
                "PROJECT_DEFAULT",
                "COMPONENT_LEAD",
                "PROJECT_LEAD",
                "UNASSIGNED"
            ]
        },
        "assignee": {
            "$ref": "#/definitions/user"
        },
        "realAssigneeType": {
            "type": "string",
            "enum": [
                "PROJECT_DEFAULT",
                "COMPONENT_LEAD",
                "PROJECT_LEAD",
                "UNASSIGNED"
            ]
        },
        "realAssignee": {
            "$ref": "#/definitions/user"
        },
        "isAssigneeTypeValid": {
            "type": "boolean"
        },
        "project": {
            "type": "string"
        },
        "projectId": {
            "type": "integer"
        }
    },
    "definitions": {
        "simple-list-wrapper": {
            "title": "Simple List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "title": "Group",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size"
            ]
        },
        "user": {
            "title": "User",
            "type": "object",
            "properties": {
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        }
    },
    "additionalProperties": false,
    "required": [
        "isAssigneeTypeValid"
    ]
}
回复
  • 状态200
    如果该组件中存在返回,目前已验证的用户有权对其进行编辑。
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/component#",
        "title": "Component",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "lead": {
                "$ref": "#/definitions/user"
            },
            "leadUserName": {
                "type": "string"
            },
            "assigneeType": {
                "type": "string",
                "enum": [
                    "PROJECT_DEFAULT",
                    "COMPONENT_LEAD",
                    "PROJECT_LEAD",
                    "UNASSIGNED"
                ]
            },
            "assignee": {
                "$ref": "#/definitions/user"
            },
            "realAssigneeType": {
                "type": "string",
                "enum": [
                    "PROJECT_DEFAULT",
                    "COMPONENT_LEAD",
                    "PROJECT_LEAD",
                    "UNASSIGNED"
                ]
            },
            "realAssignee": {
                "$ref": "#/definitions/user"
            },
            "isAssigneeTypeValid": {
                "type": "boolean"
            },
            "project": {
                "type": "string"
            },
            "projectId": {
                "type": "integer"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "isAssigneeTypeValid"
        ]
    }
  • 状态403
    返回如果当前身份验证的用户没有权限编辑组件。
  • 状态404
    如果组件不存在,或当前身份验证的用户没有权限查看它返回。

删除项目的组成部分。

请求
查询参数
参数 类型 描述
moveIssuesTo

新组件适用于它的“ID”部分将被删除的问题。 如果该值为null,则'ID'组件仅仅是从相关的所有主题中删除。

回复
  • 状态204
    返回组件是否成功删除。
  • 状态403
    返回如果当前身份验证的用户没有权限删除的组件。
  • 状态404
    如果组件不存在,或当前身份验证的用户没有权限查看它返回。

返回与此相关的组件问题计数。

回复
  • 状态200 - 应用程序/ JSON
    如果该组件中存在返回,目前已验证的用户有权限查看。 包含了与此相关的组件问题计数。
    {
        "self": "http://www.example.com/jira/rest/api/2/component/10000",
        "issueCount": 23
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/component-issue-counts#",
        "title": "Component Issue Counts",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "issueCount": {
                "type": "integer"
            }
        },
        "additionalProperties": false,
        "required": [
            "issueCount"
        ]
    }
  • 状态404
    如果组件不存在,或当前身份验证的用户没有权限查看它返回。

API / 2 /配置隐藏所有方法

返回如果JIRA的可选功能启用或禁用的信息。 如果启用了实时跟踪,它也返回有关时间跟踪配置的详细信息。

回复
  • 状态200 - 应用程序/ JSON
    返回的JIRA可选功能的配置。
    {
        "votingEnabled": true,
        "watchingEnabled": true,
        "unassignedIssuesAllowed": false,
        "subTasksEnabled": false,
        "issueLinkingEnabled": true,
        "timeTrackingEnabled": true,
        "attachmentsEnabled": true,
        "timeTrackingConfiguration": {
            "workingHoursPerDay": 8,
            "workingDaysPerWeek": 5,
            "timeFormat": "pretty",
            "defaultUnit": "day"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/configuration#",
        "title": "Configuration",
        "type": "object",
        "properties": {
            "votingEnabled": {
                "type": "boolean"
            },
            "watchingEnabled": {
                "type": "boolean"
            },
            "unassignedIssuesAllowed": {
                "type": "boolean"
            },
            "subTasksEnabled": {
                "type": "boolean"
            },
            "issueLinkingEnabled": {
                "type": "boolean"
            },
            "timeTrackingEnabled": {
                "type": "boolean"
            },
            "attachmentsEnabled": {
                "type": "boolean"
            },
            "timeTrackingConfiguration": {
                "title": "Time Tracking Configuration",
                "type": "object",
                "properties": {
                    "workingHoursPerDay": {
                        "type": "number"
                    },
                    "workingDaysPerWeek": {
                        "type": "number"
                    },
                    "timeFormat": {
                        "type": "string",
                        "enum": [
                            "pretty",
                            "days",
                            "hours"
                        ]
                    },
                    "defaultUnit": {
                        "type": "string",
                        "enum": [
                            "minute",
                            "hour",
                            "day",
                            "week"
                        ]
                    }
                },
                "additionalProperties": false,
                "required": [
                    "workingHoursPerDay",
                    "workingDaysPerWeek"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "votingEnabled",
            "watchingEnabled",
            "unassignedIssuesAllowed",
            "subTasksEnabled",
            "issueLinkingEnabled",
            "timeTrackingEnabled",
            "attachmentsEnabled"
        ]
    }
  • 状态401
    返回如果用户没有登录。

API / 2 /的CustomFieldOption 隐藏所有方法

返回具有给定id的自定义字段选项的完整表示。

回复
  • 状态200 - 应用程序/ JSON
    如果自定义字段选项存在且由主叫用户可见返回。
    {
        "self": "http://localhost:8090/jira/rest/api/2.0/customFieldOption/3",
        "value": "Blue"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/custom-field-option#",
        "title": "Custom Field Option",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "value": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果返回的自定义字段选项不存在,或者不是给主叫用户可见。

API / 2 /仪表盘隐藏所有方法

/dashboard 资源。

返回所有仪表盘的列表,随意过滤它们。

请求
查询参数
参数 类型 描述
filter

施加到仪表板的列表中的一个可选的过滤器。 有效值包括 "favourite" 用于返回唯一喜欢的仪表板,以及 "my" 用于返回由主叫用户所拥有的仪表板。

startAt INT

第一个仪表板的指数回归(从0开始)。 必须是0或多个的 maxResults

maxResults INT

一个提示,仪表盘的最大数量在每个调用返回。 需要注意的是JIRA服务器保留征收权 maxResults 的限制比一个客户提供的价值,会费缺乏或资源或任何其他条件低。 发生这种情况时,你的结果将被截断。 来电者应经常检查返回 maxResults 要确定有效使用的价值。

回复
  • 状态200
    返回仪表板的列表。
    {
        "startAt": 10,
        "maxResults": 10,
        "total": 143,
        "prev": "http://www.example.com/jira/rest/api/2/dashboard?startAt=0",
        "next": "http://www.example.com/jira/rest/api/2/dashboard?startAt=10",
        "dashboards": [
            {
                "id": "10000",
                "name": "System Dashboard",
                "self": "http://www.example.com/jira/rest/api/2/dashboard/10000",
                "view": "http://www.example.com/jira/secure/Dashboard.jspa?selectPageId=10000"
            },
            {
                "id": "20000",
                "name": "Build Engineering",
                "self": "http://www.example.com/jira/rest/api/2/dashboard/20000",
                "view": "http://www.example.com/jira/secure/Dashboard.jspa?selectPageId=20000"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/dashboards#",
        "title": "Dashboards",
        "type": "object",
        "properties": {
            "startAt": {
                "type": "integer"
            },
            "maxResults": {
                "type": "integer"
            },
            "total": {
                "type": "integer"
            },
            "prev": {
                "type": "string"
            },
            "next": {
                "type": "string"
            },
            "dashboards": {
                "type": "array",
                "items": {
                    "title": "Dashboard",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "self": {
                            "type": "string"
                        },
                        "view": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }

返回一个单一的仪表板。

回复
  • 状态200
    返回一个单一的仪表板。
    {
        "id": "10000",
        "name": "System Dashboard",
        "self": "http://www.example.com/jira/rest/api/2/dashboard/10000",
        "view": "http://www.example.com/jira/secure/Dashboard.jspa?selectPageId=10000"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/dashboard#",
        "title": "Dashboard",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "self": {
                "type": "string"
            },
            "view": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态404
    返回如果没有与指定的id的仪表盘,或者如果用户没有权限看到它。

API / 2 /仪表/ {} dashboardId /项目/ {}的itemId /属性隐藏所有方法

返回由id标识的仪表板项目的所有属性的钥匙。

回复
  • 状态200 - 应用程序/ JSON
    如果仪表板项目被发现返回。
    {
        "keys": [
            {
                "self": "http://www.example.com/jira/rest/api/2/issue/EX-2/properties/issue.support",
                "key": "issue.support"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-properties-keys#",
        "title": "Entity Properties Keys",
        "type": "object",
        "properties": {
            "keys": {
                "type": "array",
                "items": {
                    "title": "Entity Property Key",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "key": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果仪表板的项目ID无效。
  • 状态404
    如果与给定id仪表板项目不存在,或者用户没有权限来查看它返回。

移除按键式或由id标识的仪表板项目的属性。 THS用户删除属性是需要有权限管理仪表板项目。

回复
  • 状态400
    返回如果仪表板的项目ID无效。
  • 状态204
    如果返回成功删除仪表板项目属性。
  • 状态403
    返回如果调用用户没有权限编辑仪表板项目。
  • 状态404
    如果与给定id仪表板项目不存在,或者用户没有权限来查看它返回。

设置指定的仪表板项目的属性值。

你可以使用这个资源来存储对由ID标识的仪表板项目自定义数据。 谁存储数据的用户需要具有的权限管理信息中心项。

回复
  • 状态200
    返回如果仪表板项目属性成功更新。
  • 状态201
    如果成功创建仪表板项目属性返回。
  • 状态400
    返回如果仪表板的项目ID无效。
  • 状态403
    如果返回调用用户没有权限管理仪表板项目。
  • 状态404
    如果与给定id仪表板项目不存在,或者用户没有权限来查看它返回。

返回与由id标识的仪表板项目给定键的属性的值。 谁检索的属性的用户需要有权限读取仪表板项目。

回复
  • 状态200 - 应用程序/ JSON
    如果仪表板项目属性被发现返回。
    {
        "key": "issue.support",
        "value": {
            "hipchat.room.id": "support-123",
            "support.time": "1m"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-property#",
        "title": "Entity Property",
        "type": "object",
        "properties": {
            "key": {
                "type": "string"
            },
            "value": {}
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果仪表板的项目ID无效。
  • 状态404
    如果与给定id仪表板项目不存在,或者用户没有权限来查看它返回。

API / 2 /现场隐藏的所有方法

创建使用定义自定义字段(对象封装的自定义字段数据)

请求
{
    "name": "New custom field",
    "description": "Custom field for picking groups",
    "type": "com.atlassian.jira.plugin.system.customfieldtypes:grouppicker",
    "searcherKey": "com.atlassian.jira.plugin.system.customfieldtypes:grouppickersearcher"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/custom-field-definition#",
    "title": "Custom Field Definition",
    "type": "object",
    "properties": {
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "type": {
            "type": "string"
        },
        "searcherKey": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态201
    如果自定义字段创建返回。
    {
        "id": "customfield_10101",
        "name": "New custom field",
        "custom": true,
        "orderable": true,
        "navigable": true,
        "searchable": true,
        "clauseNames": [
            "cf[10101]",
            "New custom field"
        ],
        "schema": {
            "type": "project",
            "custom": "com.atlassian.jira.plugin.system.customfieldtypes:project",
            "customId": 10101
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/field#",
        "title": "Field",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "custom": {
                "type": "boolean"
            },
            "orderable": {
                "type": "boolean"
            },
            "navigable": {
                "type": "boolean"
            },
            "searchable": {
                "type": "boolean"
            },
            "clauseNames": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "schema": {
                "title": "Json Type",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string"
                    },
                    "items": {
                        "type": "string"
                    },
                    "system": {
                        "type": "string"
                    },
                    "custom": {
                        "type": "string"
                    },
                    "customId": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果输入是无效的(例如,无效值)。
  • 状态500
    如果返回除了自定义字段创建过程中发生。

返回所有字段的列表,系统和自定义

回复
  • 状态200 - 应用程序/ JSON
    包含JSON所有可见字段的完整表示。
    [
        {
            "id": "description",
            "name": "Description",
            "custom": false,
            "orderable": true,
            "navigable": true,
            "searchable": true,
            "clauseNames": [
                "description"
            ],
            "schema": {
                "type": "string",
                "system": "description"
            }
        },
        {
            "id": "summary",
            "name": "Summary",
            "custom": false,
            "orderable": true,
            "navigable": true,
            "searchable": true,
            "clauseNames": [
                "summary"
            ],
            "schema": {
                "type": "string",
                "system": "summary"
            }
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-field#",
        "title": "List of Field",
        "type": "array",
        "items": {
            "title": "Field",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "custom": {
                    "type": "boolean"
                },
                "orderable": {
                    "type": "boolean"
                },
                "navigable": {
                    "type": "boolean"
                },
                "searchable": {
                    "type": "boolean"
                },
                "clauseNames": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "schema": {
                    "title": "Json Type",
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        },
                        "items": {
                            "type": "string"
                        },
                        "system": {
                            "type": "string"
                        },
                        "custom": {
                            "type": "string"
                        },
                        "customId": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        }
    }

API / 2 /过滤器隐藏所有方法

资源,搜索。

创建一个新的过滤器,并返回新创建的过滤器。 目前台只使用默认的用户共享权限的权限

请求
查询参数
参数 类型 描述
expand

参数扩大

{
    "name": "All Open Bugs",
    "description": "Lists all open bugs",
    "jql": "type = Bug and resolution is empty",
    "favourite": true
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/filter#",
    "title": "Filter",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "owner": {
            "$ref": "#/definitions/user"
        },
        "jql": {
            "type": "string"
        },
        "viewUrl": {
            "type": "string",
            "format": "uri"
        },
        "searchUrl": {
            "type": "string",
            "format": "uri"
        },
        "favourite": {
            "type": "boolean"
        },
        "sharePermissions": {
            "type": "array",
            "items": {
                "title": "Filter Permission",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "type": {
                        "type": "string"
                    },
                    "project": {
                        "title": "Project",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "key": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "lead": {
                                "$ref": "#/definitions/user"
                            },
                            "components": {
                                "type": "array",
                                "items": {
                                    "title": "Component",
                                    "type": "object",
                                    "properties": {
                                        "name": {
                                            "type": "string"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "lead": {
                                            "$ref": "#/definitions/user"
                                        },
                                        "leadUserName": {
                                            "type": "string"
                                        },
                                        "assigneeType": {
                                            "type": "string",
                                            "enum": [
                                                "PROJECT_DEFAULT",
                                                "COMPONENT_LEAD",
                                                "PROJECT_LEAD",
                                                "UNASSIGNED"
                                            ]
                                        },
                                        "assignee": {
                                            "$ref": "#/definitions/user"
                                        },
                                        "realAssigneeType": {
                                            "type": "string",
                                            "enum": [
                                                "PROJECT_DEFAULT",
                                                "COMPONENT_LEAD",
                                                "PROJECT_LEAD",
                                                "UNASSIGNED"
                                            ]
                                        },
                                        "realAssignee": {
                                            "$ref": "#/definitions/user"
                                        },
                                        "isAssigneeTypeValid": {
                                            "type": "boolean"
                                        },
                                        "project": {
                                            "type": "string"
                                        },
                                        "projectId": {
                                            "type": "integer"
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "isAssigneeTypeValid"
                                    ]
                                }
                            },
                            "issueTypes": {
                                "type": "array",
                                "items": {
                                    "title": "Issue Type",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "iconUrl": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "subtask": {
                                            "type": "boolean"
                                        },
                                        "avatarId": {
                                            "type": "integer"
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "subtask"
                                    ]
                                }
                            },
                            "url": {
                                "type": "string"
                            },
                            "email": {
                                "type": "string"
                            },
                            "assigneeType": {
                                "type": "string",
                                "enum": [
                                    "PROJECT_LEAD",
                                    "UNASSIGNED"
                                ]
                            },
                            "versions": {
                                "type": "array",
                                "items": {
                                    "title": "Version",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "archived": {
                                            "type": "boolean"
                                        },
                                        "released": {
                                            "type": "boolean"
                                        },
                                        "overdue": {
                                            "type": "boolean"
                                        },
                                        "userStartDate": {
                                            "type": "string"
                                        },
                                        "userReleaseDate": {
                                            "type": "string"
                                        },
                                        "project": {
                                            "type": "string"
                                        },
                                        "projectId": {
                                            "type": "integer"
                                        },
                                        "moveUnfixedIssuesTo": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "operations": {
                                            "type": "array",
                                            "items": {
                                                "title": "Simple Link",
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "string"
                                                    },
                                                    "styleClass": {
                                                        "type": "string"
                                                    },
                                                    "iconClass": {
                                                        "type": "string"
                                                    },
                                                    "label": {
                                                        "type": "string"
                                                    },
                                                    "title": {
                                                        "type": "string"
                                                    },
                                                    "href": {
                                                        "type": "string"
                                                    },
                                                    "weight": {
                                                        "type": "integer"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        },
                                        "remotelinks": {
                                            "type": "array",
                                            "items": {
                                                "title": "Remote Entity Link",
                                                "type": "object",
                                                "properties": {
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "link": {}
                                                },
                                                "additionalProperties": false
                                            }
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "name": {
                                "type": "string"
                            },
                            "roles": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "type": "string",
                                        "format": "uri"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "avatarUrls": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "projectKeys": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "projectCategory": {
                                "title": "Project Category",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "projectTypeKey": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "role": {
                        "title": "Project Role",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            },
                            "id": {
                                "type": "integer"
                            },
                            "description": {
                                "type": "string"
                            },
                            "actors": {
                                "type": "array",
                                "items": {
                                    "title": "Role Actor",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "integer"
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "avatarUrl": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        },
                        "additionalProperties": false
                    },
                    "group": {
                        "$ref": "#/definitions/group"
                    }
                },
                "additionalProperties": false
            }
        },
        "sharedUsers": {
            "title": "User Bean List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "start-index": {
                    "type": "integer"
                },
                "end-index": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/user"
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size",
                "max-results",
                "start-index",
                "end-index"
            ]
        },
        "subscriptions": {
            "title": "Filter Subscription Bean List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "start-index": {
                    "type": "integer"
                },
                "end-index": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "title": "Filter Subscription",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "user": {
                                "$ref": "#/definitions/user"
                            },
                            "group": {
                                "$ref": "#/definitions/group"
                            }
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size",
                "max-results",
                "start-index",
                "end-index"
            ]
        }
    },
    "definitions": {
        "group": {
            "title": "Group",
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "simple-list-wrapper": {
            "title": "Simple List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/group"
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size"
            ]
        },
        "user": {
            "title": "User",
            "type": "object",
            "properties": {
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        }
    },
    "additionalProperties": false,
    "required": [
        "favourite"
    ]
}
回复
  • 状态200 - 应用程序/ JSON
    返回过滤器的JSON表示
    {
        "self": "http://www.example.com/jira/rest/api/2/filter/10000",
        "id": "10000",
        "name": "All Open Bugs",
        "description": "Lists all open bugs",
        "owner": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "jql": "type = Bug and resolution is empty",
        "viewUrl": "http://www.example.com/jira/issues/?filter=10000",
        "searchUrl": "http://www.example.com/jira/rest/api/2/search?jql=type%20%3D%20Bug%20and%20resolutino%20is%20empty",
        "favourite": true,
        "sharePermissions": [],
        "subscriptions": {
            "size": 0,
            "items": [],
            "max-results": 1000,
            "start-index": 0,
            "end-index": 0
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/filter#",
        "title": "Filter",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "owner": {
                "$ref": "#/definitions/user"
            },
            "jql": {
                "type": "string"
            },
            "viewUrl": {
                "type": "string",
                "format": "uri"
            },
            "searchUrl": {
                "type": "string",
                "format": "uri"
            },
            "favourite": {
                "type": "boolean"
            },
            "sharePermissions": {
                "type": "array",
                "items": {
                    "title": "Filter Permission",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "type": {
                            "type": "string"
                        },
                        "project": {
                            "title": "Project",
                            "type": "object",
                            "properties": {
                                "expand": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "id": {
                                    "type": "string"
                                },
                                "key": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "lead": {
                                    "$ref": "#/definitions/user"
                                },
                                "components": {
                                    "type": "array",
                                    "items": {
                                        "title": "Component",
                                        "type": "object",
                                        "properties": {
                                            "self": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "lead": {
                                                "$ref": "#/definitions/user"
                                            },
                                            "leadUserName": {
                                                "type": "string"
                                            },
                                            "assigneeType": {
                                                "type": "string",
                                                "enum": [
                                                    "PROJECT_DEFAULT",
                                                    "COMPONENT_LEAD",
                                                    "PROJECT_LEAD",
                                                    "UNASSIGNED"
                                                ]
                                            },
                                            "assignee": {
                                                "$ref": "#/definitions/user"
                                            },
                                            "realAssigneeType": {
                                                "type": "string",
                                                "enum": [
                                                    "PROJECT_DEFAULT",
                                                    "COMPONENT_LEAD",
                                                    "PROJECT_LEAD",
                                                    "UNASSIGNED"
                                                ]
                                            },
                                            "realAssignee": {
                                                "$ref": "#/definitions/user"
                                            },
                                            "isAssigneeTypeValid": {
                                                "type": "boolean"
                                            },
                                            "project": {
                                                "type": "string"
                                            },
                                            "projectId": {
                                                "type": "integer"
                                            }
                                        },
                                        "additionalProperties": false,
                                        "required": [
                                            "isAssigneeTypeValid"
                                        ]
                                    }
                                },
                                "issueTypes": {
                                    "type": "array",
                                    "items": {
                                        "title": "Issue Type",
                                        "type": "object",
                                        "properties": {
                                            "self": {
                                                "type": "string"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "iconUrl": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "subtask": {
                                                "type": "boolean"
                                            },
                                            "avatarId": {
                                                "type": "integer"
                                            }
                                        },
                                        "additionalProperties": false,
                                        "required": [
                                            "subtask"
                                        ]
                                    }
                                },
                                "url": {
                                    "type": "string"
                                },
                                "email": {
                                    "type": "string"
                                },
                                "assigneeType": {
                                    "type": "string",
                                    "enum": [
                                        "PROJECT_LEAD",
                                        "UNASSIGNED"
                                    ]
                                },
                                "versions": {
                                    "type": "array",
                                    "items": {
                                        "title": "Version",
                                        "type": "object",
                                        "properties": {
                                            "expand": {
                                                "type": "string"
                                            },
                                            "self": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "archived": {
                                                "type": "boolean"
                                            },
                                            "released": {
                                                "type": "boolean"
                                            },
                                            "overdue": {
                                                "type": "boolean"
                                            },
                                            "userStartDate": {
                                                "type": "string"
                                            },
                                            "userReleaseDate": {
                                                "type": "string"
                                            },
                                            "project": {
                                                "type": "string"
                                            },
                                            "projectId": {
                                                "type": "integer"
                                            },
                                            "moveUnfixedIssuesTo": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "operations": {
                                                "type": "array",
                                                "items": {
                                                    "title": "Simple Link",
                                                    "type": "object",
                                                    "properties": {
                                                        "id": {
                                                            "type": "string"
                                                        },
                                                        "styleClass": {
                                                            "type": "string"
                                                        },
                                                        "iconClass": {
                                                            "type": "string"
                                                        },
                                                        "label": {
                                                            "type": "string"
                                                        },
                                                        "title": {
                                                            "type": "string"
                                                        },
                                                        "href": {
                                                            "type": "string"
                                                        },
                                                        "weight": {
                                                            "type": "integer"
                                                        }
                                                    },
                                                    "additionalProperties": false
                                                }
                                            },
                                            "remotelinks": {
                                                "type": "array",
                                                "items": {
                                                    "title": "Remote Entity Link",
                                                    "type": "object",
                                                    "properties": {
                                                        "self": {
                                                            "type": "string",
                                                            "format": "uri"
                                                        },
                                                        "name": {
                                                            "type": "string"
                                                        },
                                                        "link": {}
                                                    },
                                                    "additionalProperties": false
                                                }
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                },
                                "name": {
                                    "type": "string"
                                },
                                "roles": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "avatarUrls": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectKeys": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "projectCategory": {
                                    "title": "Project Category",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "id": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "description": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectTypeKey": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "role": {
                            "title": "Project Role",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "id": {
                                    "type": "integer"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "actors": {
                                    "type": "array",
                                    "items": {
                                        "title": "Role Actor",
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "integer"
                                            },
                                            "displayName": {
                                                "type": "string"
                                            },
                                            "type": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "avatarUrl": {
                                                "type": "string",
                                                "format": "uri"
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                }
                            },
                            "additionalProperties": false
                        },
                        "group": {
                            "$ref": "#/definitions/group"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "sharedUsers": {
                "title": "User Bean List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "start-index": {
                        "type": "integer"
                    },
                    "end-index": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/user"
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size",
                    "max-results",
                    "start-index",
                    "end-index"
                ]
            },
            "subscriptions": {
                "title": "Filter Subscription Bean List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "start-index": {
                        "type": "integer"
                    },
                    "end-index": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Filter Subscription",
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer"
                                },
                                "user": {
                                    "$ref": "#/definitions/user"
                                },
                                "group": {
                                    "$ref": "#/definitions/group"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size",
                    "max-results",
                    "start-index",
                    "end-index"
                ]
            }
        },
        "definitions": {
            "group": {
                "title": "Group",
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "self": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/group"
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "favourite"
        ]
    }
  • 状态400
    如果返回输入无效(未提供如过滤器名称)。

返回给定的过滤器的ID

请求
查询参数
参数 类型 描述
expand

参数扩大

回复
  • 状态200 - 应用程序/ JSON
    返回过滤器的JSON表示
    {
        "self": "http://www.example.com/jira/rest/api/2/filter/10000",
        "id": "10000",
        "name": "All Open Bugs",
        "description": "Lists all open bugs",
        "owner": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "jql": "type = Bug and resolution is empty",
        "viewUrl": "http://www.example.com/jira/issues/?filter=10000",
        "searchUrl": "http://www.example.com/jira/rest/api/2/search?jql=type%20%3D%20Bug%20and%20resolutino%20is%20empty",
        "favourite": true,
        "sharePermissions": [],
        "subscriptions": {
            "size": 0,
            "items": [],
            "max-results": 1000,
            "start-index": 0,
            "end-index": 0
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/filter#",
        "title": "Filter",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "owner": {
                "$ref": "#/definitions/user"
            },
            "jql": {
                "type": "string"
            },
            "viewUrl": {
                "type": "string",
                "format": "uri"
            },
            "searchUrl": {
                "type": "string",
                "format": "uri"
            },
            "favourite": {
                "type": "boolean"
            },
            "sharePermissions": {
                "type": "array",
                "items": {
                    "title": "Filter Permission",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "type": {
                            "type": "string"
                        },
                        "project": {
                            "title": "Project",
                            "type": "object",
                            "properties": {
                                "expand": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "id": {
                                    "type": "string"
                                },
                                "key": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "lead": {
                                    "$ref": "#/definitions/user"
                                },
                                "components": {
                                    "type": "array",
                                    "items": {
                                        "title": "Component",
                                        "type": "object",
                                        "properties": {
                                            "self": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "lead": {
                                                "$ref": "#/definitions/user"
                                            },
                                            "leadUserName": {
                                                "type": "string"
                                            },
                                            "assigneeType": {
                                                "type": "string",
                                                "enum": [
                                                    "PROJECT_DEFAULT",
                                                    "COMPONENT_LEAD",
                                                    "PROJECT_LEAD",
                                                    "UNASSIGNED"
                                                ]
                                            },
                                            "assignee": {
                                                "$ref": "#/definitions/user"
                                            },
                                            "realAssigneeType": {
                                                "type": "string",
                                                "enum": [
                                                    "PROJECT_DEFAULT",
                                                    "COMPONENT_LEAD",
                                                    "PROJECT_LEAD",
                                                    "UNASSIGNED"
                                                ]
                                            },
                                            "realAssignee": {
                                                "$ref": "#/definitions/user"
                                            },
                                            "isAssigneeTypeValid": {
                                                "type": "boolean"
                                            },
                                            "project": {
                                                "type": "string"
                                            },
                                            "projectId": {
                                                "type": "integer"
                                            }
                                        },
                                        "additionalProperties": false,
                                        "required": [
                                            "isAssigneeTypeValid"
                                        ]
                                    }
                                },
                                "issueTypes": {
                                    "type": "array",
                                    "items": {
                                        "title": "Issue Type",
                                        "type": "object",
                                        "properties": {
                                            "self": {
                                                "type": "string"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "iconUrl": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "subtask": {
                                                "type": "boolean"
                                            },
                                            "avatarId": {
                                                "type": "integer"
                                            }
                                        },
                                        "additionalProperties": false,
                                        "required": [
                                            "subtask"
                                        ]
                                    }
                                },
                                "url": {
                                    "type": "string"
                                },
                                "email": {
                                    "type": "string"
                                },
                                "assigneeType": {
                                    "type": "string",
                                    "enum": [
                                        "PROJECT_LEAD",
                                        "UNASSIGNED"
                                    ]
                                },
                                "versions": {
                                    "type": "array",
                                    "items": {
                                        "title": "Version",
                                        "type": "object",
                                        "properties": {
                                            "expand": {
                                                "type": "string"
                                            },
                                            "self": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "archived": {
                                                "type": "boolean"
                                            },
                                            "released": {
                                                "type": "boolean"
                                            },
                                            "overdue": {
                                                "type": "boolean"
                                            },
                                            "userStartDate": {
                                                "type": "string"
                                            },
                                            "userReleaseDate": {
                                                "type": "string"
                                            },
                                            "project": {
                                                "type": "string"
                                            },
                                            "projectId": {
                                                "type": "integer"
                                            },
                                            "moveUnfixedIssuesTo": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "operations": {
                                                "type": "array",
                                                "items": {
                                                    "title": "Simple Link",
                                                    "type": "object",
                                                    "properties": {
                                                        "id": {
                                                            "type": "string"
                                                        },
                                                        "styleClass": {
                                                            "type": "string"
                                                        },
                                                        "iconClass": {
                                                            "type": "string"
                                                        },
                                                        "label": {
                                                            "type": "string"
                                                        },
                                                        "title": {
                                                            "type": "string"
                                                        },
                                                        "href": {
                                                            "type": "string"
                                                        },
                                                        "weight": {
                                                            "type": "integer"
                                                        }
                                                    },
                                                    "additionalProperties": false
                                                }
                                            },
                                            "remotelinks": {
                                                "type": "array",
                                                "items": {
                                                    "title": "Remote Entity Link",
                                                    "type": "object",
                                                    "properties": {
                                                        "self": {
                                                            "type": "string",
                                                            "format": "uri"
                                                        },
                                                        "name": {
                                                            "type": "string"
                                                        },
                                                        "link": {}
                                                    },
                                                    "additionalProperties": false
                                                }
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                },
                                "name": {
                                    "type": "string"
                                },
                                "roles": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "avatarUrls": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectKeys": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "projectCategory": {
                                    "title": "Project Category",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "id": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "description": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectTypeKey": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "role": {
                            "title": "Project Role",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "id": {
                                    "type": "integer"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "actors": {
                                    "type": "array",
                                    "items": {
                                        "title": "Role Actor",
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "integer"
                                            },
                                            "displayName": {
                                                "type": "string"
                                            },
                                            "type": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "avatarUrl": {
                                                "type": "string",
                                                "format": "uri"
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                }
                            },
                            "additionalProperties": false
                        },
                        "group": {
                            "$ref": "#/definitions/group"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "sharedUsers": {
                "title": "User Bean List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "start-index": {
                        "type": "integer"
                    },
                    "end-index": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/user"
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size",
                    "max-results",
                    "start-index",
                    "end-index"
                ]
            },
            "subscriptions": {
                "title": "Filter Subscription Bean List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "start-index": {
                        "type": "integer"
                    },
                    "end-index": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Filter Subscription",
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer"
                                },
                                "user": {
                                    "$ref": "#/definitions/user"
                                },
                                "group": {
                                    "$ref": "#/definitions/group"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size",
                    "max-results",
                    "start-index",
                    "end-index"
                ]
            }
        },
        "definitions": {
            "group": {
                "title": "Group",
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "self": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/group"
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "favourite"
        ]
    }
  • 状态400
    返回如果有仰视的过滤器的问题给出的ID

更新现有的过滤器,并返回其新的价值。

请求
查询参数
参数 类型 描述
expand

参数扩大

{
    "name": "All Open Bugs",
    "description": "Lists all open bugs",
    "jql": "type = Bug and resolution is empty",
    "favourite": true
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/filter#",
    "title": "Filter",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "owner": {
            "$ref": "#/definitions/user"
        },
        "jql": {
            "type": "string"
        },
        "viewUrl": {
            "type": "string",
            "format": "uri"
        },
        "searchUrl": {
            "type": "string",
            "format": "uri"
        },
        "favourite": {
            "type": "boolean"
        },
        "sharePermissions": {
            "type": "array",
            "items": {
                "title": "Filter Permission",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "type": {
                        "type": "string"
                    },
                    "project": {
                        "title": "Project",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "key": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "lead": {
                                "$ref": "#/definitions/user"
                            },
                            "components": {
                                "type": "array",
                                "items": {
                                    "title": "Component",
                                    "type": "object",
                                    "properties": {
                                        "name": {
                                            "type": "string"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "lead": {
                                            "$ref": "#/definitions/user"
                                        },
                                        "leadUserName": {
                                            "type": "string"
                                        },
                                        "assigneeType": {
                                            "type": "string",
                                            "enum": [
                                                "PROJECT_DEFAULT",
                                                "COMPONENT_LEAD",
                                                "PROJECT_LEAD",
                                                "UNASSIGNED"
                                            ]
                                        },
                                        "assignee": {
                                            "$ref": "#/definitions/user"
                                        },
                                        "realAssigneeType": {
                                            "type": "string",
                                            "enum": [
                                                "PROJECT_DEFAULT",
                                                "COMPONENT_LEAD",
                                                "PROJECT_LEAD",
                                                "UNASSIGNED"
                                            ]
                                        },
                                        "realAssignee": {
                                            "$ref": "#/definitions/user"
                                        },
                                        "isAssigneeTypeValid": {
                                            "type": "boolean"
                                        },
                                        "project": {
                                            "type": "string"
                                        },
                                        "projectId": {
                                            "type": "integer"
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "isAssigneeTypeValid"
                                    ]
                                }
                            },
                            "issueTypes": {
                                "type": "array",
                                "items": {
                                    "title": "Issue Type",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "iconUrl": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "subtask": {
                                            "type": "boolean"
                                        },
                                        "avatarId": {
                                            "type": "integer"
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "subtask"
                                    ]
                                }
                            },
                            "url": {
                                "type": "string"
                            },
                            "email": {
                                "type": "string"
                            },
                            "assigneeType": {
                                "type": "string",
                                "enum": [
                                    "PROJECT_LEAD",
                                    "UNASSIGNED"
                                ]
                            },
                            "versions": {
                                "type": "array",
                                "items": {
                                    "title": "Version",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "archived": {
                                            "type": "boolean"
                                        },
                                        "released": {
                                            "type": "boolean"
                                        },
                                        "overdue": {
                                            "type": "boolean"
                                        },
                                        "userStartDate": {
                                            "type": "string"
                                        },
                                        "userReleaseDate": {
                                            "type": "string"
                                        },
                                        "project": {
                                            "type": "string"
                                        },
                                        "projectId": {
                                            "type": "integer"
                                        },
                                        "moveUnfixedIssuesTo": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "operations": {
                                            "type": "array",
                                            "items": {
                                                "title": "Simple Link",
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "string"
                                                    },
                                                    "styleClass": {
                                                        "type": "string"
                                                    },
                                                    "iconClass": {
                                                        "type": "string"
                                                    },
                                                    "label": {
                                                        "type": "string"
                                                    },
                                                    "title": {
                                                        "type": "string"
                                                    },
                                                    "href": {
                                                        "type": "string"
                                                    },
                                                    "weight": {
                                                        "type": "integer"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        },
                                        "remotelinks": {
                                            "type": "array",
                                            "items": {
                                                "title": "Remote Entity Link",
                                                "type": "object",
                                                "properties": {
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "link": {}
                                                },
                                                "additionalProperties": false
                                            }
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "name": {
                                "type": "string"
                            },
                            "roles": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "type": "string",
                                        "format": "uri"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "avatarUrls": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "projectKeys": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "projectCategory": {
                                "title": "Project Category",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "projectTypeKey": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "role": {
                        "title": "Project Role",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            },
                            "id": {
                                "type": "integer"
                            },
                            "description": {
                                "type": "string"
                            },
                            "actors": {
                                "type": "array",
                                "items": {
                                    "title": "Role Actor",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "integer"
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "avatarUrl": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        },
                        "additionalProperties": false
                    },
                    "group": {
                        "$ref": "#/definitions/group"
                    }
                },
                "additionalProperties": false
            }
        },
        "sharedUsers": {
            "title": "User Bean List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "start-index": {
                    "type": "integer"
                },
                "end-index": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/user"
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size",
                "max-results",
                "start-index",
                "end-index"
            ]
        },
        "subscriptions": {
            "title": "Filter Subscription Bean List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "start-index": {
                    "type": "integer"
                },
                "end-index": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "title": "Filter Subscription",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "user": {
                                "$ref": "#/definitions/user"
                            },
                            "group": {
                                "$ref": "#/definitions/group"
                            }
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size",
                "max-results",
                "start-index",
                "end-index"
            ]
        }
    },
    "definitions": {
        "group": {
            "title": "Group",
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "simple-list-wrapper": {
            "title": "Simple List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/group"
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size"
            ]
        },
        "user": {
            "title": "User",
            "type": "object",
            "properties": {
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        }
    },
    "additionalProperties": false,
    "required": [
        "favourite"
    ]
}
回复
  • 状态200 - 应用程序/ JSON
    返回过滤器的JSON表示
    {
        "self": "http://www.example.com/jira/rest/api/2/filter/10000",
        "id": "10000",
        "name": "All Open Bugs",
        "description": "Lists all open bugs",
        "owner": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "jql": "type = Bug and resolution is empty",
        "viewUrl": "http://www.example.com/jira/issues/?filter=10000",
        "searchUrl": "http://www.example.com/jira/rest/api/2/search?jql=type%20%3D%20Bug%20and%20resolutino%20is%20empty",
        "favourite": true,
        "sharePermissions": [],
        "subscriptions": {
            "size": 0,
            "items": [],
            "max-results": 1000,
            "start-index": 0,
            "end-index": 0
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/filter#",
        "title": "Filter",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "owner": {
                "$ref": "#/definitions/user"
            },
            "jql": {
                "type": "string"
            },
            "viewUrl": {
                "type": "string",
                "format": "uri"
            },
            "searchUrl": {
                "type": "string",
                "format": "uri"
            },
            "favourite": {
                "type": "boolean"
            },
            "sharePermissions": {
                "type": "array",
                "items": {
                    "title": "Filter Permission",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "type": {
                            "type": "string"
                        },
                        "project": {
                            "title": "Project",
                            "type": "object",
                            "properties": {
                                "expand": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "id": {
                                    "type": "string"
                                },
                                "key": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "lead": {
                                    "$ref": "#/definitions/user"
                                },
                                "components": {
                                    "type": "array",
                                    "items": {
                                        "title": "Component",
                                        "type": "object",
                                        "properties": {
                                            "self": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "lead": {
                                                "$ref": "#/definitions/user"
                                            },
                                            "leadUserName": {
                                                "type": "string"
                                            },
                                            "assigneeType": {
                                                "type": "string",
                                                "enum": [
                                                    "PROJECT_DEFAULT",
                                                    "COMPONENT_LEAD",
                                                    "PROJECT_LEAD",
                                                    "UNASSIGNED"
                                                ]
                                            },
                                            "assignee": {
                                                "$ref": "#/definitions/user"
                                            },
                                            "realAssigneeType": {
                                                "type": "string",
                                                "enum": [
                                                    "PROJECT_DEFAULT",
                                                    "COMPONENT_LEAD",
                                                    "PROJECT_LEAD",
                                                    "UNASSIGNED"
                                                ]
                                            },
                                            "realAssignee": {
                                                "$ref": "#/definitions/user"
                                            },
                                            "isAssigneeTypeValid": {
                                                "type": "boolean"
                                            },
                                            "project": {
                                                "type": "string"
                                            },
                                            "projectId": {
                                                "type": "integer"
                                            }
                                        },
                                        "additionalProperties": false,
                                        "required": [
                                            "isAssigneeTypeValid"
                                        ]
                                    }
                                },
                                "issueTypes": {
                                    "type": "array",
                                    "items": {
                                        "title": "Issue Type",
                                        "type": "object",
                                        "properties": {
                                            "self": {
                                                "type": "string"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "iconUrl": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "subtask": {
                                                "type": "boolean"
                                            },
                                            "avatarId": {
                                                "type": "integer"
                                            }
                                        },
                                        "additionalProperties": false,
                                        "required": [
                                            "subtask"
                                        ]
                                    }
                                },
                                "url": {
                                    "type": "string"
                                },
                                "email": {
                                    "type": "string"
                                },
                                "assigneeType": {
                                    "type": "string",
                                    "enum": [
                                        "PROJECT_LEAD",
                                        "UNASSIGNED"
                                    ]
                                },
                                "versions": {
                                    "type": "array",
                                    "items": {
                                        "title": "Version",
                                        "type": "object",
                                        "properties": {
                                            "expand": {
                                                "type": "string"
                                            },
                                            "self": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "archived": {
                                                "type": "boolean"
                                            },
                                            "released": {
                                                "type": "boolean"
                                            },
                                            "overdue": {
                                                "type": "boolean"
                                            },
                                            "userStartDate": {
                                                "type": "string"
                                            },
                                            "userReleaseDate": {
                                                "type": "string"
                                            },
                                            "project": {
                                                "type": "string"
                                            },
                                            "projectId": {
                                                "type": "integer"
                                            },
                                            "moveUnfixedIssuesTo": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "operations": {
                                                "type": "array",
                                                "items": {
                                                    "title": "Simple Link",
                                                    "type": "object",
                                                    "properties": {
                                                        "id": {
                                                            "type": "string"
                                                        },
                                                        "styleClass": {
                                                            "type": "string"
                                                        },
                                                        "iconClass": {
                                                            "type": "string"
                                                        },
                                                        "label": {
                                                            "type": "string"
                                                        },
                                                        "title": {
                                                            "type": "string"
                                                        },
                                                        "href": {
                                                            "type": "string"
                                                        },
                                                        "weight": {
                                                            "type": "integer"
                                                        }
                                                    },
                                                    "additionalProperties": false
                                                }
                                            },
                                            "remotelinks": {
                                                "type": "array",
                                                "items": {
                                                    "title": "Remote Entity Link",
                                                    "type": "object",
                                                    "properties": {
                                                        "self": {
                                                            "type": "string",
                                                            "format": "uri"
                                                        },
                                                        "name": {
                                                            "type": "string"
                                                        },
                                                        "link": {}
                                                    },
                                                    "additionalProperties": false
                                                }
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                },
                                "name": {
                                    "type": "string"
                                },
                                "roles": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "avatarUrls": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectKeys": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "projectCategory": {
                                    "title": "Project Category",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "id": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "description": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectTypeKey": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "role": {
                            "title": "Project Role",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "id": {
                                    "type": "integer"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "actors": {
                                    "type": "array",
                                    "items": {
                                        "title": "Role Actor",
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "integer"
                                            },
                                            "displayName": {
                                                "type": "string"
                                            },
                                            "type": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "avatarUrl": {
                                                "type": "string",
                                                "format": "uri"
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                }
                            },
                            "additionalProperties": false
                        },
                        "group": {
                            "$ref": "#/definitions/group"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "sharedUsers": {
                "title": "User Bean List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "start-index": {
                        "type": "integer"
                    },
                    "end-index": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/user"
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size",
                    "max-results",
                    "start-index",
                    "end-index"
                ]
            },
            "subscriptions": {
                "title": "Filter Subscription Bean List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "start-index": {
                        "type": "integer"
                    },
                    "end-index": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Filter Subscription",
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer"
                                },
                                "user": {
                                    "$ref": "#/definitions/user"
                                },
                                "group": {
                                    "$ref": "#/definitions/group"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size",
                    "max-results",
                    "start-index",
                    "end-index"
                ]
            }
        },
        "definitions": {
            "group": {
                "title": "Group",
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "self": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/group"
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "favourite"
        ]
    }
  • 状态400
    返回如果有更新了给定id的过滤器的问题

删除过滤器。

回复
  • 状态400
    如果发生错误,返回。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态204
    返回如果过滤器被成功取出。

返回给定过滤器的默认列。 当前登录的用户将被用作制造这种请求的用户。

回复
  • 状态200 - 应用程序/ JSON
    返回列的列表进行配置给定用户
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-column-layout-item#",
        "title": "List of Column Layout Item",
        "type": "array",
        "items": {
            "title": "Column Layout Item",
            "type": "object",
            "properties": {
                "columnHeadingKey": {
                    "type": "string"
                },
                "id": {
                    "type": "string"
                },
                "navigableField": {
                    "title": "Navigable Field",
                    "type": "object",
                    "properties": {
                        "columnCssClass": {
                            "type": "string"
                        },
                        "columnHeadingKey": {
                            "type": "string"
                        },
                        "defaultSortOrder": {
                            "type": "string"
                        },
                        "hiddenFieldId": {
                            "type": "string"
                        },
                        "sortComparatorSource": {
                            "title": "Field Comparator Source",
                            "type": "object"
                        },
                        "sorter": {
                            "title": "Lucene Field Sorter",
                            "type": "object",
                            "properties": {
                                "comparator": {
                                    "type": "object"
                                },
                                "documentConstant": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "additionalProperties": false
                },
                "position": {
                    "type": "integer"
                }
            },
            "additionalProperties": false,
            "required": [
                "position"
            ]
        }
    }
  • 状态500
    返回如果检索列配置发生了错误。
  • 状态404
    如果过滤器没有任何列返回。

设置为给定的过滤器默认列。

请求
回复
  • 状态200
    当列保存成功返回
  • 状态500
    返回如果检索列配置发生了错误。

重置列给定的过滤器,使得过滤器不再有其自己的列配置。

回复
  • 状态500
    返回如果检索列配置发生了错误。
  • 状态204
    当返回的列被重置/删除成功

返回给定过滤器的所有共享权限。

回复
  • 状态200 - 应用程序/ JSON
    如果返回成功。
    [
        {
            "id": 10000,
            "type": "global"
        },
        {
            "id": 10010,
            "type": "project",
            "project": {
                "self": "http://www.example.com/jira/rest/api/2/project/EX",
                "id": "10000",
                "key": "EX",
                "name": "Example",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10000",
                    "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10000",
                    "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10000",
                    "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10000"
                },
                "projectCategory": {
                    "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
                    "id": "10000",
                    "name": "FIRST",
                    "description": "First Project Category"
                }
            }
        },
        {
            "id": 10010,
            "type": "project",
            "project": {
                "self": "http://www.example.com/jira/rest/api/2/project/MKY",
                "id": "10002",
                "key": "MKY",
                "name": "Example",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10002",
                    "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10002",
                    "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10002",
                    "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10002"
                },
                "projectCategory": {
                    "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
                    "id": "10000",
                    "name": "FIRST",
                    "description": "First Project Category"
                }
            },
            "role": {
                "self": "http://www.example.com/jira/rest/api/2/project/MKY/role/10360",
                "name": "Developers",
                "id": 10360,
                "description": "A project role that represents developers in a project",
                "actors": [
                    {
                        "id": 10240,
                        "displayName": "jira-developers",
                        "type": "atlassian-group-role-actor",
                        "name": "jira-developers"
                    }
                ]
            }
        },
        {
            "id": 10010,
            "type": "group",
            "group": {
                "name": "jira-administrators",
                "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-administrators"
            }
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-filter-permission#",
        "title": "List of Filter Permission",
        "type": "array",
        "items": {
            "title": "Filter Permission",
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "type": {
                    "type": "string"
                },
                "project": {
                    "title": "Project",
                    "type": "object",
                    "properties": {
                        "expand": {
                            "type": "string"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "id": {
                            "type": "string"
                        },
                        "key": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "lead": {
                            "$ref": "#/definitions/user"
                        },
                        "components": {
                            "type": "array",
                            "items": {
                                "title": "Component",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "lead": {
                                        "$ref": "#/definitions/user"
                                    },
                                    "leadUserName": {
                                        "type": "string"
                                    },
                                    "assigneeType": {
                                        "type": "string",
                                        "enum": [
                                            "PROJECT_DEFAULT",
                                            "COMPONENT_LEAD",
                                            "PROJECT_LEAD",
                                            "UNASSIGNED"
                                        ]
                                    },
                                    "assignee": {
                                        "$ref": "#/definitions/user"
                                    },
                                    "realAssigneeType": {
                                        "type": "string",
                                        "enum": [
                                            "PROJECT_DEFAULT",
                                            "COMPONENT_LEAD",
                                            "PROJECT_LEAD",
                                            "UNASSIGNED"
                                        ]
                                    },
                                    "realAssignee": {
                                        "$ref": "#/definitions/user"
                                    },
                                    "isAssigneeTypeValid": {
                                        "type": "boolean"
                                    },
                                    "project": {
                                        "type": "string"
                                    },
                                    "projectId": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false,
                                "required": [
                                    "isAssigneeTypeValid"
                                ]
                            }
                        },
                        "issueTypes": {
                            "type": "array",
                            "items": {
                                "title": "Issue Type",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "iconUrl": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "subtask": {
                                        "type": "boolean"
                                    },
                                    "avatarId": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false,
                                "required": [
                                    "subtask"
                                ]
                            }
                        },
                        "url": {
                            "type": "string"
                        },
                        "email": {
                            "type": "string"
                        },
                        "assigneeType": {
                            "type": "string",
                            "enum": [
                                "PROJECT_LEAD",
                                "UNASSIGNED"
                            ]
                        },
                        "versions": {
                            "type": "array",
                            "items": {
                                "title": "Version",
                                "type": "object",
                                "properties": {
                                    "expand": {
                                        "type": "string"
                                    },
                                    "self": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "archived": {
                                        "type": "boolean"
                                    },
                                    "released": {
                                        "type": "boolean"
                                    },
                                    "overdue": {
                                        "type": "boolean"
                                    },
                                    "userStartDate": {
                                        "type": "string"
                                    },
                                    "userReleaseDate": {
                                        "type": "string"
                                    },
                                    "project": {
                                        "type": "string"
                                    },
                                    "projectId": {
                                        "type": "integer"
                                    },
                                    "moveUnfixedIssuesTo": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "operations": {
                                        "type": "array",
                                        "items": {
                                            "title": "Simple Link",
                                            "type": "object",
                                            "properties": {
                                                "id": {
                                                    "type": "string"
                                                },
                                                "styleClass": {
                                                    "type": "string"
                                                },
                                                "iconClass": {
                                                    "type": "string"
                                                },
                                                "label": {
                                                    "type": "string"
                                                },
                                                "title": {
                                                    "type": "string"
                                                },
                                                "href": {
                                                    "type": "string"
                                                },
                                                "weight": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "remotelinks": {
                                        "type": "array",
                                        "items": {
                                            "title": "Remote Entity Link",
                                            "type": "object",
                                            "properties": {
                                                "self": {
                                                    "type": "string",
                                                    "format": "uri"
                                                },
                                                "name": {
                                                    "type": "string"
                                                },
                                                "link": {}
                                            },
                                            "additionalProperties": false
                                        }
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "name": {
                            "type": "string"
                        },
                        "roles": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        },
                        "avatarUrls": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "projectKeys": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        },
                        "projectCategory": {
                            "title": "Project Category",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "id": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "projectTypeKey": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "role": {
                    "title": "Project Role",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "name": {
                            "type": "string"
                        },
                        "id": {
                            "type": "integer"
                        },
                        "description": {
                            "type": "string"
                        },
                        "actors": {
                            "type": "array",
                            "items": {
                                "title": "Role Actor",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "integer"
                                    },
                                    "displayName": {
                                        "type": "string"
                                    },
                                    "type": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "avatarUrl": {
                                        "type": "string",
                                        "format": "uri"
                                    }
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                },
                "group": {
                    "$ref": "#/definitions/group"
                }
            },
            "additionalProperties": false
        },
        "definitions": {
            "group": {
                "title": "Group",
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "self": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/group"
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        }
    }
  • 状态401
    如果返回的用户没有登录。
  • 状态404
    当给定的ID过滤器不存在,或者当用户没有权限查看该过滤器返回。

增加了共享权限给定的过滤器。 添加一个全局权限将删除过滤器的所有以前的权限。

请求
{
    "type": "group",
    "groupname": "jira-administrators"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/share-permission-input#",
    "title": "Share Permission Input",
    "type": "object",
    "properties": {
        "type": {
            "type": "string"
        },
        "projectId": {
            "type": "string"
        },
        "groupname": {
            "type": "string"
        },
        "projectRoleId": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    如果返回成功。
    [
        {
            "id": 10000,
            "type": "global"
        },
        {
            "id": 10010,
            "type": "project",
            "project": {
                "self": "http://www.example.com/jira/rest/api/2/project/EX",
                "id": "10000",
                "key": "EX",
                "name": "Example",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10000",
                    "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10000",
                    "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10000",
                    "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10000"
                },
                "projectCategory": {
                    "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
                    "id": "10000",
                    "name": "FIRST",
                    "description": "First Project Category"
                }
            }
        },
        {
            "id": 10010,
            "type": "project",
            "project": {
                "self": "http://www.example.com/jira/rest/api/2/project/MKY",
                "id": "10002",
                "key": "MKY",
                "name": "Example",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10002",
                    "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10002",
                    "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10002",
                    "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10002"
                },
                "projectCategory": {
                    "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
                    "id": "10000",
                    "name": "FIRST",
                    "description": "First Project Category"
                }
            },
            "role": {
                "self": "http://www.example.com/jira/rest/api/2/project/MKY/role/10360",
                "name": "Developers",
                "id": 10360,
                "description": "A project role that represents developers in a project",
                "actors": [
                    {
                        "id": 10240,
                        "displayName": "jira-developers",
                        "type": "atlassian-group-role-actor",
                        "name": "jira-developers"
                    }
                ]
            }
        },
        {
            "id": 10010,
            "type": "group",
            "group": {
                "name": "jira-administrators",
                "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-administrators"
            }
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-filter-permission#",
        "title": "List of Filter Permission",
        "type": "array",
        "items": {
            "title": "Filter Permission",
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "type": {
                    "type": "string"
                },
                "project": {
                    "title": "Project",
                    "type": "object",
                    "properties": {
                        "expand": {
                            "type": "string"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "id": {
                            "type": "string"
                        },
                        "key": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "lead": {
                            "$ref": "#/definitions/user"
                        },
                        "components": {
                            "type": "array",
                            "items": {
                                "title": "Component",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "lead": {
                                        "$ref": "#/definitions/user"
                                    },
                                    "leadUserName": {
                                        "type": "string"
                                    },
                                    "assigneeType": {
                                        "type": "string",
                                        "enum": [
                                            "PROJECT_DEFAULT",
                                            "COMPONENT_LEAD",
                                            "PROJECT_LEAD",
                                            "UNASSIGNED"
                                        ]
                                    },
                                    "assignee": {
                                        "$ref": "#/definitions/user"
                                    },
                                    "realAssigneeType": {
                                        "type": "string",
                                        "enum": [
                                            "PROJECT_DEFAULT",
                                            "COMPONENT_LEAD",
                                            "PROJECT_LEAD",
                                            "UNASSIGNED"
                                        ]
                                    },
                                    "realAssignee": {
                                        "$ref": "#/definitions/user"
                                    },
                                    "isAssigneeTypeValid": {
                                        "type": "boolean"
                                    },
                                    "project": {
                                        "type": "string"
                                    },
                                    "projectId": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false,
                                "required": [
                                    "isAssigneeTypeValid"
                                ]
                            }
                        },
                        "issueTypes": {
                            "type": "array",
                            "items": {
                                "title": "Issue Type",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "iconUrl": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "subtask": {
                                        "type": "boolean"
                                    },
                                    "avatarId": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false,
                                "required": [
                                    "subtask"
                                ]
                            }
                        },
                        "url": {
                            "type": "string"
                        },
                        "email": {
                            "type": "string"
                        },
                        "assigneeType": {
                            "type": "string",
                            "enum": [
                                "PROJECT_LEAD",
                                "UNASSIGNED"
                            ]
                        },
                        "versions": {
                            "type": "array",
                            "items": {
                                "title": "Version",
                                "type": "object",
                                "properties": {
                                    "expand": {
                                        "type": "string"
                                    },
                                    "self": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "archived": {
                                        "type": "boolean"
                                    },
                                    "released": {
                                        "type": "boolean"
                                    },
                                    "overdue": {
                                        "type": "boolean"
                                    },
                                    "userStartDate": {
                                        "type": "string"
                                    },
                                    "userReleaseDate": {
                                        "type": "string"
                                    },
                                    "project": {
                                        "type": "string"
                                    },
                                    "projectId": {
                                        "type": "integer"
                                    },
                                    "moveUnfixedIssuesTo": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "operations": {
                                        "type": "array",
                                        "items": {
                                            "title": "Simple Link",
                                            "type": "object",
                                            "properties": {
                                                "id": {
                                                    "type": "string"
                                                },
                                                "styleClass": {
                                                    "type": "string"
                                                },
                                                "iconClass": {
                                                    "type": "string"
                                                },
                                                "label": {
                                                    "type": "string"
                                                },
                                                "title": {
                                                    "type": "string"
                                                },
                                                "href": {
                                                    "type": "string"
                                                },
                                                "weight": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "remotelinks": {
                                        "type": "array",
                                        "items": {
                                            "title": "Remote Entity Link",
                                            "type": "object",
                                            "properties": {
                                                "self": {
                                                    "type": "string",
                                                    "format": "uri"
                                                },
                                                "name": {
                                                    "type": "string"
                                                },
                                                "link": {}
                                            },
                                            "additionalProperties": false
                                        }
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "name": {
                            "type": "string"
                        },
                        "roles": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        },
                        "avatarUrls": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "projectKeys": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        },
                        "projectCategory": {
                            "title": "Project Category",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "id": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "projectTypeKey": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "role": {
                    "title": "Project Role",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "name": {
                            "type": "string"
                        },
                        "id": {
                            "type": "integer"
                        },
                        "description": {
                            "type": "string"
                        },
                        "actors": {
                            "type": "array",
                            "items": {
                                "title": "Role Actor",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "integer"
                                    },
                                    "displayName": {
                                        "type": "string"
                                    },
                                    "type": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "avatarUrl": {
                                        "type": "string",
                                        "format": "uri"
                                    }
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                },
                "group": {
                    "$ref": "#/definitions/group"
                }
            },
            "additionalProperties": false
        },
        "definitions": {
            "group": {
                "title": "Group",
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "self": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/group"
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        }
    }
  • 状态400
    回到获准输入bean是无效或当用户没有共享的过滤器或当用户无法编辑定的过滤器的权限。
  • 状态401
    如果返回的用户没有登录。
  • 状态404
    当给定的ID过滤器不存在,或者当用户没有权限查看该过滤器返回。

返回给定过滤器的单一共享权限。

回复
  • 状态200 - 应用程序/ JSON
    如果返回成功。
    {
        "id": 10000,
        "type": "global"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/filter-permission#",
        "title": "Filter Permission",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "type": {
                "type": "string"
            },
            "project": {
                "title": "Project",
                "type": "object",
                "properties": {
                    "expand": {
                        "type": "string"
                    },
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "id": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "description": {
                        "type": "string"
                    },
                    "lead": {
                        "$ref": "#/definitions/user"
                    },
                    "components": {
                        "type": "array",
                        "items": {
                            "title": "Component",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "id": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "lead": {
                                    "$ref": "#/definitions/user"
                                },
                                "leadUserName": {
                                    "type": "string"
                                },
                                "assigneeType": {
                                    "type": "string",
                                    "enum": [
                                        "PROJECT_DEFAULT",
                                        "COMPONENT_LEAD",
                                        "PROJECT_LEAD",
                                        "UNASSIGNED"
                                    ]
                                },
                                "assignee": {
                                    "$ref": "#/definitions/user"
                                },
                                "realAssigneeType": {
                                    "type": "string",
                                    "enum": [
                                        "PROJECT_DEFAULT",
                                        "COMPONENT_LEAD",
                                        "PROJECT_LEAD",
                                        "UNASSIGNED"
                                    ]
                                },
                                "realAssignee": {
                                    "$ref": "#/definitions/user"
                                },
                                "isAssigneeTypeValid": {
                                    "type": "boolean"
                                },
                                "project": {
                                    "type": "string"
                                },
                                "projectId": {
                                    "type": "integer"
                                }
                            },
                            "additionalProperties": false,
                            "required": [
                                "isAssigneeTypeValid"
                            ]
                        }
                    },
                    "issueTypes": {
                        "type": "array",
                        "items": {
                            "title": "Issue Type",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string"
                                },
                                "id": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "iconUrl": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "subtask": {
                                    "type": "boolean"
                                },
                                "avatarId": {
                                    "type": "integer"
                                }
                            },
                            "additionalProperties": false,
                            "required": [
                                "subtask"
                            ]
                        }
                    },
                    "url": {
                        "type": "string"
                    },
                    "email": {
                        "type": "string"
                    },
                    "assigneeType": {
                        "type": "string",
                        "enum": [
                            "PROJECT_LEAD",
                            "UNASSIGNED"
                        ]
                    },
                    "versions": {
                        "type": "array",
                        "items": {
                            "title": "Version",
                            "type": "object",
                            "properties": {
                                "expand": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "id": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "archived": {
                                    "type": "boolean"
                                },
                                "released": {
                                    "type": "boolean"
                                },
                                "overdue": {
                                    "type": "boolean"
                                },
                                "userStartDate": {
                                    "type": "string"
                                },
                                "userReleaseDate": {
                                    "type": "string"
                                },
                                "project": {
                                    "type": "string"
                                },
                                "projectId": {
                                    "type": "integer"
                                },
                                "moveUnfixedIssuesTo": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "operations": {
                                    "type": "array",
                                    "items": {
                                        "title": "Simple Link",
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "string"
                                            },
                                            "styleClass": {
                                                "type": "string"
                                            },
                                            "iconClass": {
                                                "type": "string"
                                            },
                                            "label": {
                                                "type": "string"
                                            },
                                            "title": {
                                                "type": "string"
                                            },
                                            "href": {
                                                "type": "string"
                                            },
                                            "weight": {
                                                "type": "integer"
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                },
                                "remotelinks": {
                                    "type": "array",
                                    "items": {
                                        "title": "Remote Entity Link",
                                        "type": "object",
                                        "properties": {
                                            "self": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "link": {}
                                        },
                                        "additionalProperties": false
                                    }
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "name": {
                        "type": "string"
                    },
                    "roles": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "projectKeys": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "projectCategory": {
                        "title": "Project Category",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string",
                                "format": "uri"
                            },
                            "id": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "projectTypeKey": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "role": {
                "title": "Project Role",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "name": {
                        "type": "string"
                    },
                    "id": {
                        "type": "integer"
                    },
                    "description": {
                        "type": "string"
                    },
                    "actors": {
                        "type": "array",
                        "items": {
                            "title": "Role Actor",
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer"
                                },
                                "displayName": {
                                    "type": "string"
                                },
                                "type": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "avatarUrl": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false
            },
            "group": {
                "$ref": "#/definitions/group"
            }
        },
        "definitions": {
            "group": {
                "title": "Group",
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "self": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/group"
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    如果返回的用户没有登录。
  • 状态404
    当过滤器或许可给定id不存在,或者当用户没有权限查看该过滤器返回。

移除给定的过滤器的共享权限。

回复
  • 状态200 - 应用程序/ JSON
  • 状态204
    如果返回成功。
  • 状态404
    当过滤器或许可给定id不存在,或者当用户没有权限查看该过滤器返回。

返回登录用户的默认共享范围。

回复
  • 状态200 - 应用程序/ JSON
    返回登录用户的默认共享范围。
    {
        "scope": "GLOBAL"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/default-share-scope#",
        "title": "Default Share Scope",
        "type": "object",
        "properties": {
            "scope": {
                "type": "string",
                "enum": [
                    "GLOBAL",
                    "PRIVATE"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回,如果有仰视用于登录的用户偏好中的问题

设置登录用户的默认共享范围。 可用的值有全局和专用。

请求
{
    "scope": "GLOBAL"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/default-share-scope#",
    "title": "Default Share Scope",
    "type": "object",
    "properties": {
        "scope": {
            "type": "string",
            "enum": [
                "GLOBAL",
                "PRIVATE"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    返回登录用户的新的默认共享范围。
    {
        "scope": "GLOBAL"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/default-share-scope#",
        "title": "Default Share Scope",
        "type": "object",
        "properties": {
            "scope": {
                "type": "string",
                "enum": [
                    "GLOBAL",
                    "PRIVATE"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回,如果有一个问题设定登录的用户的偏好

返回登录用户的喜爱的过滤器。

请求
查询参数
参数 类型 描述
expand

参数扩大

回复
  • 状态200 - 应用程序/ JSON
    返回的过滤器列表的JSON表示
    [
        {
            "self": "http://www.example.com/jira/rest/api/2/filter/10000",
            "id": "10000",
            "name": "All Open Bugs",
            "description": "Lists all open bugs",
            "owner": {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                    "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                    "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                    "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                },
                "displayName": "Fred F. User",
                "active": false
            },
            "jql": "type = Bug and resolution is empty",
            "viewUrl": "http://www.example.com/jira/issues/?filter=10000",
            "searchUrl": "http://www.example.com/jira/rest/api/2/search?jql=type%20%3D%20Bug%20and%20resolutino%20is%20empty",
            "favourite": true,
            "sharePermissions": [],
            "subscriptions": {
                "size": 0,
                "items": [],
                "max-results": 1000,
                "start-index": 0,
                "end-index": 0
            }
        },
        {
            "self": "http://www.example.com/jira/rest/api/2/filter/10010",
            "id": "10010",
            "name": "My issues",
            "description": "Issues assigned to me",
            "owner": {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                    "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                    "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                    "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                },
                "displayName": "Fred F. User",
                "active": false
            },
            "jql": "assignee = currentUser() and resolution is empty",
            "viewUrl": "http://www.example.com/jira/issues/?filter=10010",
            "searchUrl": "http://www.example.com/jira/rest/api/2/search?jql=assignee+in+%28currentUser%28%29%29+and+resolution+is+empty",
            "favourite": true,
            "sharePermissions": [
                {
                    "id": 10000,
                    "type": "global"
                },
                {
                    "id": 10010,
                    "type": "project",
                    "project": {
                        "self": "http://www.example.com/jira/rest/api/2/project/EX",
                        "id": "10000",
                        "key": "EX",
                        "name": "Example",
                        "avatarUrls": {
                            "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10000",
                            "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10000",
                            "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10000",
                            "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10000"
                        },
                        "projectCategory": {
                            "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
                            "id": "10000",
                            "name": "FIRST",
                            "description": "First Project Category"
                        }
                    }
                }
            ],
            "subscriptions": {
                "size": 0,
                "items": [],
                "max-results": 1000,
                "start-index": 0,
                "end-index": 0
            }
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-filter#",
        "title": "List of Filter",
        "type": "array",
        "items": {
            "title": "Filter",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "id": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "owner": {
                    "$ref": "#/definitions/user"
                },
                "jql": {
                    "type": "string"
                },
                "viewUrl": {
                    "type": "string",
                    "format": "uri"
                },
                "searchUrl": {
                    "type": "string",
                    "format": "uri"
                },
                "favourite": {
                    "type": "boolean"
                },
                "sharePermissions": {
                    "type": "array",
                    "items": {
                        "title": "Filter Permission",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "integer"
                            },
                            "type": {
                                "type": "string"
                            },
                            "project": {
                                "title": "Project",
                                "type": "object",
                                "properties": {
                                    "expand": {
                                        "type": "string"
                                    },
                                    "self": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "key": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "lead": {
                                        "$ref": "#/definitions/user"
                                    },
                                    "components": {
                                        "type": "array",
                                        "items": {
                                            "title": "Component",
                                            "type": "object",
                                            "properties": {
                                                "self": {
                                                    "type": "string",
                                                    "format": "uri"
                                                },
                                                "id": {
                                                    "type": "string"
                                                },
                                                "name": {
                                                    "type": "string"
                                                },
                                                "description": {
                                                    "type": "string"
                                                },
                                                "lead": {
                                                    "$ref": "#/definitions/user"
                                                },
                                                "leadUserName": {
                                                    "type": "string"
                                                },
                                                "assigneeType": {
                                                    "type": "string",
                                                    "enum": [
                                                        "PROJECT_DEFAULT",
                                                        "COMPONENT_LEAD",
                                                        "PROJECT_LEAD",
                                                        "UNASSIGNED"
                                                    ]
                                                },
                                                "assignee": {
                                                    "$ref": "#/definitions/user"
                                                },
                                                "realAssigneeType": {
                                                    "type": "string",
                                                    "enum": [
                                                        "PROJECT_DEFAULT",
                                                        "COMPONENT_LEAD",
                                                        "PROJECT_LEAD",
                                                        "UNASSIGNED"
                                                    ]
                                                },
                                                "realAssignee": {
                                                    "$ref": "#/definitions/user"
                                                },
                                                "isAssigneeTypeValid": {
                                                    "type": "boolean"
                                                },
                                                "project": {
                                                    "type": "string"
                                                },
                                                "projectId": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false,
                                            "required": [
                                                "isAssigneeTypeValid"
                                            ]
                                        }
                                    },
                                    "issueTypes": {
                                        "type": "array",
                                        "items": {
                                            "title": "Issue Type",
                                            "type": "object",
                                            "properties": {
                                                "self": {
                                                    "type": "string"
                                                },
                                                "id": {
                                                    "type": "string"
                                                },
                                                "description": {
                                                    "type": "string"
                                                },
                                                "iconUrl": {
                                                    "type": "string"
                                                },
                                                "name": {
                                                    "type": "string"
                                                },
                                                "subtask": {
                                                    "type": "boolean"
                                                },
                                                "avatarId": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false,
                                            "required": [
                                                "subtask"
                                            ]
                                        }
                                    },
                                    "url": {
                                        "type": "string"
                                    },
                                    "email": {
                                        "type": "string"
                                    },
                                    "assigneeType": {
                                        "type": "string",
                                        "enum": [
                                            "PROJECT_LEAD",
                                            "UNASSIGNED"
                                        ]
                                    },
                                    "versions": {
                                        "type": "array",
                                        "items": {
                                            "title": "Version",
                                            "type": "object",
                                            "properties": {
                                                "expand": {
                                                    "type": "string"
                                                },
                                                "self": {
                                                    "type": "string",
                                                    "format": "uri"
                                                },
                                                "id": {
                                                    "type": "string"
                                                },
                                                "description": {
                                                    "type": "string"
                                                },
                                                "name": {
                                                    "type": "string"
                                                },
                                                "archived": {
                                                    "type": "boolean"
                                                },
                                                "released": {
                                                    "type": "boolean"
                                                },
                                                "overdue": {
                                                    "type": "boolean"
                                                },
                                                "userStartDate": {
                                                    "type": "string"
                                                },
                                                "userReleaseDate": {
                                                    "type": "string"
                                                },
                                                "project": {
                                                    "type": "string"
                                                },
                                                "projectId": {
                                                    "type": "integer"
                                                },
                                                "moveUnfixedIssuesTo": {
                                                    "type": "string",
                                                    "format": "uri"
                                                },
                                                "operations": {
                                                    "type": "array",
                                                    "items": {
                                                        "title": "Simple Link",
                                                        "type": "object",
                                                        "properties": {
                                                            "id": {
                                                                "type": "string"
                                                            },
                                                            "styleClass": {
                                                                "type": "string"
                                                            },
                                                            "iconClass": {
                                                                "type": "string"
                                                            },
                                                            "label": {
                                                                "type": "string"
                                                            },
                                                            "title": {
                                                                "type": "string"
                                                            },
                                                            "href": {
                                                                "type": "string"
                                                            },
                                                            "weight": {
                                                                "type": "integer"
                                                            }
                                                        },
                                                        "additionalProperties": false
                                                    }
                                                },
                                                "remotelinks": {
                                                    "type": "array",
                                                    "items": {
                                                        "title": "Remote Entity Link",
                                                        "type": "object",
                                                        "properties": {
                                                            "self": {
                                                                "type": "string",
                                                                "format": "uri"
                                                            },
                                                            "name": {
                                                                "type": "string"
                                                            },
                                                            "link": {}
                                                        },
                                                        "additionalProperties": false
                                                    }
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "roles": {
                                        "type": "object",
                                        "patternProperties": {
                                            ".+": {
                                                "type": "string",
                                                "format": "uri"
                                            }
                                        },
                                        "additionalProperties": false
                                    },
                                    "avatarUrls": {
                                        "type": "object",
                                        "patternProperties": {
                                            ".+": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false
                                    },
                                    "projectKeys": {
                                        "type": "array",
                                        "items": {
                                            "type": "string"
                                        }
                                    },
                                    "projectCategory": {
                                        "title": "Project Category",
                                        "type": "object",
                                        "properties": {
                                            "self": {
                                                "type": "string",
                                                "format": "uri"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false
                                    },
                                    "projectTypeKey": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "role": {
                                "title": "Project Role",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "id": {
                                        "type": "integer"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "actors": {
                                        "type": "array",
                                        "items": {
                                            "title": "Role Actor",
                                            "type": "object",
                                            "properties": {
                                                "id": {
                                                    "type": "integer"
                                                },
                                                "displayName": {
                                                    "type": "string"
                                                },
                                                "type": {
                                                    "type": "string"
                                                },
                                                "name": {
                                                    "type": "string"
                                                },
                                                "avatarUrl": {
                                                    "type": "string",
                                                    "format": "uri"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    }
                                },
                                "additionalProperties": false
                            },
                            "group": {
                                "$ref": "#/definitions/group"
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "sharedUsers": {
                    "title": "User Bean List Wrapper",
                    "type": "object",
                    "properties": {
                        "size": {
                            "type": "integer"
                        },
                        "max-results": {
                            "type": "integer"
                        },
                        "start-index": {
                            "type": "integer"
                        },
                        "end-index": {
                            "type": "integer"
                        },
                        "items": {
                            "type": "array",
                            "items": {
                                "$ref": "#/definitions/user"
                            }
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "size",
                        "max-results",
                        "start-index",
                        "end-index"
                    ]
                },
                "subscriptions": {
                    "title": "Filter Subscription Bean List Wrapper",
                    "type": "object",
                    "properties": {
                        "size": {
                            "type": "integer"
                        },
                        "max-results": {
                            "type": "integer"
                        },
                        "start-index": {
                            "type": "integer"
                        },
                        "end-index": {
                            "type": "integer"
                        },
                        "items": {
                            "type": "array",
                            "items": {
                                "title": "Filter Subscription",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "integer"
                                    },
                                    "user": {
                                        "$ref": "#/definitions/user"
                                    },
                                    "group": {
                                        "$ref": "#/definitions/group"
                                    }
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "size",
                        "max-results",
                        "start-index",
                        "end-index"
                    ]
                }
            },
            "additionalProperties": false,
            "required": [
                "favourite"
            ]
        },
        "definitions": {
            "group": {
                "title": "Group",
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "self": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/group"
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        }
    }

API / 2 /组隐藏所有方法

通过给定的组参数创建一个组

返回REST表示对请求的组。

请求
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/add-group#",
    "title": "Add Group",
    "type": "object",
    "properties": {
        "name": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    返回JSON格式的JIRA组充分的代表性。
    {
        "name": "jira-administrators",
        "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-administrators",
        "users": {
            "size": 1,
            "items": [
                {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "displayName": "Fred F. User",
                    "active": false
                }
            ],
            "max-results": 50,
            "start-index": 0,
            "end-index": 0
        },
        "expand": "users"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/group#",
        "title": "Group",
        "type": "object",
        "properties": {
            "name": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "users": {
                "title": "Paged List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "start-index": {
                        "type": "integer"
                    },
                    "end-index": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "User",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "key": {
                                    "type": "string"
                                },
                                "emailAddress": {
                                    "type": "string"
                                },
                                "avatarUrls": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "displayName": {
                                    "type": "string"
                                },
                                "active": {
                                    "type": "boolean"
                                },
                                "timeZone": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false,
                            "required": [
                                "active"
                            ]
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size",
                    "max-results",
                    "start-index",
                    "end-index"
                ]
            },
            "expand": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果返回用户请求一个空的组名或组已存在
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态403
    如果当前用户没有管理员权限返回。

返回REST表示对请求的组。 如果允许“用户”的扩大提供选项来获得属于指定组的活跃用户及其子组的列表。 您可以通过用户列表页面使用指标的参数扩展。 例如,从指数10获得用户15指数采用“用户[10:15]”扩大值。 这将返回6用户(如果有至少16个用户,这组)。 索引是从0开始的,包容的。

此资源已过时,请使用组/成员API来代替。

请求
查询参数
参数 类型 描述
groupname

要求组的名称。

expand

字段列表扩大。 目前仅可扩大为“用户”。

回复
  • 状态 - 应用程序/ JSON

删除一组由下式给出组参数。

返回任何内容

请求
查询参数
参数 类型 描述
groupname

(强制)组的名称删除。

swapGroup

如果您删除组和内容仅限于该组,内容将从所有用户隐藏。 为了防止这种情况,使用此参数指定不同组的限制(仅限意见和worklogs)转让。

回复
  • 状态200 - 应用程序/ JSON
    如果该组被删除返回。
  • 状态400
    如果用户请求一个不存在的组返回。
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态403
    如果当前用户没有管理员权限返回。
  • 状态404
    如果没有找到请求的组返回。

该资源返回 分页 谁是指定的组及其子组成员的用户列表。 在页面的用户通过用户名排序。 该资源的用户需要有系统管理员或管理员权限。

请求
查询参数
参数 类型 描述
groupname

对于哪些成员将返回该组的名称。

includeInactiveUsers 布尔

默认值:

不活动的用户将被纳入响应,如果设置为true。

startAt

默认值: 0

第一用户的组的索引返回(0开始)。

maxResults INT

默认值: 50

用户的最大数目,返回(最多50个)。

回复
  • 状态200 - 应用程序/ JSON
    该组中的用户的分页列表。
    {
        "self": "http://www.example.com/jira/rest/api/2/group/member?groupname=jira-administrators&includeInactiveUsers=false&startAt=2&maxResults=2",
        "nextPage": "http://www.example.com/jira/rest/api/2/group/member?groupname=jira-administrators&includeInactiveUsers=false&startAt=4&maxResults=2",
        "maxResults": 2,
        "startAt": 3,
        "total": 5,
        "isLast": false,
        "values": [
            {
                "self": "http://example/jira/rest/api/2/user?username=fred",
                "name": "Fred",
                "key": "fred",
                "emailAddress": "fred@atlassian.com",
                "avatarUrls": {},
                "displayName": "Fred",
                "active": true,
                "timeZone": "Australia/Sydney"
            },
            {
                "self": "http://example/jira/rest/api/2/user?username=barney",
                "name": "Barney",
                "key": "barney",
                "emailAddress": "barney@atlassian.com",
                "avatarUrls": {},
                "displayName": "Barney",
                "active": false,
                "timeZone": "Australia/Sydney"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/group#",
        "title": "Group",
        "type": "object",
        "properties": {
            "name": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "users": {
                "title": "Paged List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "start-index": {
                        "type": "integer"
                    },
                    "end-index": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "User",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "key": {
                                    "type": "string"
                                },
                                "emailAddress": {
                                    "type": "string"
                                },
                                "avatarUrls": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "displayName": {
                                    "type": "string"
                                },
                                "active": {
                                    "type": "boolean"
                                },
                                "timeZone": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false,
                            "required": [
                                "active"
                            ]
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size",
                    "max-results",
                    "start-index",
                    "end-index"
                ]
            },
            "expand": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回,如果提供的团体的名称为空
  • 状态401
    返回如果用户没有登录。
  • 状态403
    返回如果调用用户不是管理员或系统管理员
  • 状态404
    如果指定的组不存在返回

添加给定的用户到一个组。

返回该组的当前状态。

请求
查询参数
参数 类型 描述
groupname

要求组的名称。

{
    "name": "charlie"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/update-user-to-group#",
    "title": "Update User To Group",
    "type": "object",
    "properties": {
        "name": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    返回JSON格式的JIRA组充分的代表性。
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/group#",
        "title": "Group",
        "type": "object",
        "properties": {
            "name": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "users": {
                "title": "Paged List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "start-index": {
                        "type": "integer"
                    },
                    "end-index": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "User",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "key": {
                                    "type": "string"
                                },
                                "emailAddress": {
                                    "type": "string"
                                },
                                "avatarUrls": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "displayName": {
                                    "type": "string"
                                },
                                "active": {
                                    "type": "boolean"
                                },
                                "timeZone": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false,
                            "required": [
                                "active"
                            ]
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size",
                    "max-results",
                    "start-index",
                    "end-index"
                ]
            },
            "expand": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    或者返回如果用户请求一个空的组名用户已经属于该组。
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态403
    如果当前用户没有管理员权限返回。
  • 状态404
    如果请求的组未找到或要求用户找不到返回。

移除一组给定的用户。

返回任何内容

请求
查询参数
参数 类型 描述
groupname

要求组的名称。

username

用户从一组中删除

回复
  • 状态200 - 应用程序/ JSON
    如果用户从该组中删除。
  • 状态400
    如果返回用户请求一个空的组名
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态403
    如果当前用户没有管理员权限返回。
  • 状态404
    或者返回如果请求的组未发现被请求的用户婉未找到

API / 2 /组隐藏所有方法

REST端点在一组选取器搜索组

返回匹配给定查询子组。 这主要是为与该组选择器的使用,所以返回的基团含有的html用作选择器的建议。 该集团也裹着也包含在选择器中使用的标头一个响应对象,特别是 显示ÿ匹配组第X

基团的数目返回由系统属性“jira.ajax.autocomplete.limit”不限

该团体将是唯一的和分类。

请求
查询参数
参数 类型 描述
query

一个字符串匹配组agains

exclude
maxResults INT
userName
回复
  • 状态200 - 应用程序/ JSON
    返回即使没有组给定的子字符串匹配
    {
        "header": "Showing 20 of 25 matching groups",
        "total": 25,
        "groups": [
            {
                "name": "jdog-developers",
                "html": "<b>j</b>dog-developers"
            },
            {
                "name": "juvenal-bot",
                "html": "<b>j</b>uvenal-bot"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/group-suggestions#",
        "title": "Group Suggestions",
        "type": "object",
        "properties": {
            "header": {
                "type": "string"
            },
            "total": {
                "type": "integer"
            },
            "groups": {
                "type": "array",
                "items": {
                    "title": "Group Suggestion",
                    "type": "object",
                    "properties": {
                        "name": {
                            "type": "string"
                        },
                        "html": {
                            "type": "string"
                        },
                        "labels": {
                            "type": "array",
                            "items": {
                                "title": "Group Label",
                                "type": "object",
                                "properties": {
                                    "text": {
                                        "type": "string"
                                    },
                                    "title": {
                                        "type": "string"
                                    },
                                    "type": {
                                        "type": "string",
                                        "enum": [
                                            "ADMIN",
                                            "SINGLE",
                                            "MULTIPLE"
                                        ]
                                    }
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }

API / 2 / groupuserpicker 隐藏所有方法

返回用户和与突出匹配查询组的列表。 此资源不能被匿名访问。

请求
查询参数
参数 类型 描述
query

使用的字符串搜索用户名,姓名或电子邮件地址

maxResults INT

用户的最大数量返回(默认为50)。 最大允许值为1000。如果指定的值比这个数字更高,搜索结果将被截断。

showAvatar 布尔
fieldId

自定义字段标识,如果这个请求来自一个自定义字段,如用户选择器。 可选的。

projectId

项目ID列表,以进一步限制搜索此参数可以多次出现在多个项目IDS通过。 不支持逗号分隔值。 当fieldId存在此参数仅使用。

issueTypeId

问题类型的ID列表,以进一步限制搜索。 此参数可以多次出现在多个问题类型IDS通过。 不支持逗号分隔值。 特殊值如-1(所有标准问题类型)-2(所有子任务问题类型)的支持。 当fieldId存在此参数仅使用。

回复
  • 状态200
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/users-and-groups#",
        "title": "Users And Groups",
        "type": "object",
        "properties": {
            "users": {
                "title": "User Picker Results",
                "type": "object",
                "properties": {
                    "users": {
                        "type": "array",
                        "items": {
                            "title": "User Picker User",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "key": {
                                    "type": "string"
                                },
                                "html": {
                                    "type": "string"
                                },
                                "displayName": {
                                    "type": "string"
                                },
                                "avatarUrl": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "total": {
                        "type": "integer"
                    },
                    "header": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "groups": {
                "title": "Group Suggestions",
                "type": "object",
                "properties": {
                    "header": {
                        "type": "string"
                    },
                    "total": {
                        "type": "integer"
                    },
                    "groups": {
                        "type": "array",
                        "items": {
                            "title": "Group Suggestion",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "html": {
                                    "type": "string"
                                },
                                "labels": {
                                    "type": "array",
                                    "items": {
                                        "title": "Group Label",
                                        "type": "object",
                                        "properties": {
                                            "text": {
                                                "type": "string"
                                            },
                                            "title": {
                                                "type": "string"
                                            },
                                            "type": {
                                                "type": "string",
                                                "enum": [
                                                    "ADMIN",
                                                    "SINGLE",
                                                    "MULTIPLE"
                                                ]
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }

API / 2 /问题隐藏所有方法

创建一个问题或JSON表示一个子任务。

可以在创建进行设置,在任何领域的参数或更新参数字段可以用确定 / REST / API / 2 /问题/ createmeta 资源。 如果字段没有被配置为显示在创建屏幕上,那么它将不会在createmeta,并且如果它被提交会发生场验证错误。

创建一个子任务类似于创建一个普通的问题,有两个重要的区别:

  • issueType 字段必须对应一个子任务问题类型(可以使用 /issue/createmeta 发现子任务问题类型),和
  • 你必须提供一个 parent 在外地的问题创建包含ID或父问题的关键要求。

请求
{
    "update": {
        "worklog": [
            {
                "add": {
                    "timeSpent": "60m",
                    "started": "2011-07-05T11:05:00.000+0000"
                }
            }
        ]
    },
    "fields": {
        "project": {
            "id": "10000"
        },
        "summary": "something's wrong",
        "issuetype": {
            "id": "10000"
        },
        "assignee": {
            "name": "homer"
        },
        "reporter": {
            "name": "smithers"
        },
        "priority": {
            "id": "20000"
        },
        "labels": [
            "bugfix",
            "blitz_test"
        ],
        "timetracking": {
            "originalEstimate": "10",
            "remainingEstimate": "5"
        },
        "security": {
            "id": "10000"
        },
        "versions": [
            {
                "id": "10000"
            }
        ],
        "environment": "environment",
        "description": "description",
        "duedate": "2011-03-11",
        "fixVersions": [
            {
                "id": "10001"
            }
        ],
        "components": [
            {
                "id": "10000"
            }
        ],
        "customfield_30000": [
            "10000",
            "10002"
        ],
        "customfield_80000": {
            "value": "red"
        },
        "customfield_20000": "06/Jul/11 3:25 PM",
        "customfield_40000": "this is a text field",
        "customfield_70000": [
            "jira-administrators",
            "jira-software-users"
        ],
        "customfield_60000": "jira-software-users",
        "customfield_50000": "this is a text area. big text.",
        "customfield_10000": "09/Jun/81"
    }
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/issue-update#",
    "title": "Issue Update",
    "type": "object",
    "properties": {
        "transition": {
            "title": "Transition",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "to": {
                    "title": "Status",
                    "type": "object",
                    "properties": {
                        "statusColor": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "iconUrl": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "statusCategory": {
                            "title": "Status Category",
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer"
                                },
                                "key": {
                                    "type": "string"
                                },
                                "colorName": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "additionalProperties": false
                },
                "fields": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "title": "Field Meta",
                            "type": "object",
                            "properties": {
                                "required": {
                                    "type": "boolean"
                                },
                                "schema": {
                                    "title": "Json Type",
                                    "type": "object",
                                    "properties": {
                                        "type": {
                                            "type": "string"
                                        },
                                        "items": {
                                            "type": "string"
                                        },
                                        "system": {
                                            "type": "string"
                                        },
                                        "custom": {
                                            "type": "string"
                                        },
                                        "customId": {
                                            "type": "integer"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "name": {
                                    "type": "string"
                                },
                                "autoCompleteUrl": {
                                    "type": "string"
                                },
                                "hasDefaultValue": {
                                    "type": "boolean"
                                },
                                "operations": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "allowedValues": {
                                    "type": "array",
                                    "items": {}
                                }
                            },
                            "additionalProperties": false,
                            "required": [
                                "required"
                            ]
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        },
        "fields": {
            "type": "object",
            "patternProperties": {
                ".+": {}
            },
            "additionalProperties": false
        },
        "update": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "array",
                    "items": {
                        "title": "Field Operation",
                        "type": "object"
                    }
                }
            },
            "additionalProperties": false
        },
        "historyMetadata": {
            "title": "History Metadata",
            "type": "object",
            "properties": {
                "type": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "descriptionKey": {
                    "type": "string"
                },
                "activityDescription": {
                    "type": "string"
                },
                "activityDescriptionKey": {
                    "type": "string"
                },
                "emailDescription": {
                    "type": "string"
                },
                "emailDescriptionKey": {
                    "type": "string"
                },
                "actor": {
                    "$ref": "#/definitions/history-metadata-participant"
                },
                "generator": {
                    "$ref": "#/definitions/history-metadata-participant"
                },
                "cause": {
                    "$ref": "#/definitions/history-metadata-participant"
                },
                "extraData": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        },
        "properties": {
            "type": "array",
            "items": {
                "title": "Entity Property",
                "type": "object",
                "properties": {
                    "key": {
                        "type": "string"
                    },
                    "value": {}
                },
                "additionalProperties": false
            }
        }
    },
    "definitions": {
        "history-metadata-participant": {
            "title": "History Metadata Participant",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "displayName": {
                    "type": "string"
                },
                "displayNameKey": {
                    "type": "string"
                },
                "type": {
                    "type": "string"
                },
                "avatarUrl": {
                    "type": "string"
                },
                "url": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    返回的链接创建问题。
    {
        "id": "10000",
        "key": "TST-24",
        "self": "http://www.example.com/jira/rest/api/2/issue/10000"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-create-response#",
        "title": "Issue Create Response",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "key": {
                "type": "string"
            },
            "self": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果返回输入无效(例如缺少必填字段,无效字段值,等等)。
    {
        "errorMessages": [
            "Field 'priority' is required"
        ],
        "errors": {}
    }

从创建JSON表示问题或子任务。

创建一个批量操作的许多问题。

创建一个子任务类似于创建一个普通的问题。 更多细节可以在createIssue部分找到:{@link IssueResource#createIssue(IssueUpdateBean)}}

请求
{
    "issueUpdates": [
        {
            "update": {
                "worklog": [
                    {
                        "add": {
                            "timeSpent": "60m",
                            "started": "2011-07-05T11:05:00.000+0000"
                        }
                    }
                ]
            },
            "fields": {
                "project": {
                    "id": "10000"
                },
                "summary": "something's wrong",
                "issuetype": {
                    "id": "10000"
                },
                "assignee": {
                    "name": "homer"
                },
                "reporter": {
                    "name": "smithers"
                },
                "priority": {
                    "id": "20000"
                },
                "labels": [
                    "bugfix",
                    "blitz_test"
                ],
                "timetracking": {
                    "originalEstimate": "10",
                    "remainingEstimate": "5"
                },
                "security": {
                    "id": "10000"
                },
                "versions": [
                    {
                        "id": "10000"
                    }
                ],
                "environment": "environment",
                "description": "description",
                "duedate": "2011-03-11",
                "fixVersions": [
                    {
                        "id": "10001"
                    }
                ],
                "components": [
                    {
                        "id": "10000"
                    }
                ],
                "customfield_30000": [
                    "10000",
                    "10002"
                ],
                "customfield_80000": {
                    "value": "red"
                },
                "customfield_20000": "06/Jul/11 3:25 PM",
                "customfield_40000": "this is a text field",
                "customfield_70000": [
                    "jira-administrators",
                    "jira-software-users"
                ],
                "customfield_60000": "jira-software-users",
                "customfield_50000": "this is a text area. big text.",
                "customfield_10000": "09/Jun/81"
            }
        },
        {
            "update": {},
            "fields": {
                "project": {
                    "id": "1000"
                },
                "summary": "something's very wrong",
                "issuetype": {
                    "id": "10000"
                },
                "assignee": {
                    "name": "jerry"
                },
                "reporter": {
                    "name": "kosecki"
                },
                "priority": {
                    "id": "20000"
                },
                "labels": [
                    "new_release"
                ],
                "timetracking": {
                    "originalEstimate": "15",
                    "remainingEstimate": "5"
                },
                "security": {
                    "id": "10000"
                },
                "versions": [
                    {
                        "id": "10000"
                    }
                ],
                "environment": "environment",
                "description": "description",
                "duedate": "2011-04-16",
                "fixVersions": [
                    {
                        "id": "10001"
                    }
                ],
                "components": [
                    {
                        "id": "10000"
                    }
                ],
                "customfield_30000": [
                    "10000",
                    "10002"
                ],
                "customfield_80000": {
                    "value": "red"
                },
                "customfield_20000": "06/Jul/11 3:25 PM",
                "customfield_40000": "this is a text field",
                "customfield_70000": [
                    "jira-administrators",
                    "jira-software-users"
                ],
                "customfield_60000": "jira-software-users",
                "customfield_50000": "this is a text area. big text.",
                "customfield_10000": "09/Jun/81"
            }
        }
    ]
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/issues-update#",
    "title": "Issues Update",
    "type": "object",
    "properties": {
        "issueUpdates": {
            "type": "array",
            "items": {
                "title": "Issue Update",
                "type": "object",
                "properties": {
                    "transition": {
                        "title": "Transition",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "to": {
                                "title": "Status",
                                "type": "object",
                                "properties": {
                                    "statusColor": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "iconUrl": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "statusCategory": {
                                        "title": "Status Category",
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "integer"
                                            },
                                            "key": {
                                                "type": "string"
                                            },
                                            "colorName": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                },
                                "additionalProperties": false
                            },
                            "fields": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "title": "Field Meta",
                                        "type": "object",
                                        "properties": {
                                            "required": {
                                                "type": "boolean"
                                            },
                                            "schema": {
                                                "title": "Json Type",
                                                "type": "object",
                                                "properties": {
                                                    "type": {
                                                        "type": "string"
                                                    },
                                                    "items": {
                                                        "type": "string"
                                                    },
                                                    "system": {
                                                        "type": "string"
                                                    },
                                                    "custom": {
                                                        "type": "string"
                                                    },
                                                    "customId": {
                                                        "type": "integer"
                                                    }
                                                },
                                                "additionalProperties": false
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "autoCompleteUrl": {
                                                "type": "string"
                                            },
                                            "hasDefaultValue": {
                                                "type": "boolean"
                                            },
                                            "operations": {
                                                "type": "array",
                                                "items": {
                                                    "type": "string"
                                                }
                                            },
                                            "allowedValues": {
                                                "type": "array",
                                                "items": {}
                                            }
                                        },
                                        "additionalProperties": false,
                                        "required": [
                                            "required"
                                        ]
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "additionalProperties": false
                    },
                    "fields": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {}
                        },
                        "additionalProperties": false
                    },
                    "update": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "array",
                                "items": {
                                    "title": "Field Operation",
                                    "type": "object"
                                }
                            }
                        },
                        "additionalProperties": false
                    },
                    "historyMetadata": {
                        "title": "History Metadata",
                        "type": "object",
                        "properties": {
                            "type": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "descriptionKey": {
                                "type": "string"
                            },
                            "activityDescription": {
                                "type": "string"
                            },
                            "activityDescriptionKey": {
                                "type": "string"
                            },
                            "emailDescription": {
                                "type": "string"
                            },
                            "emailDescriptionKey": {
                                "type": "string"
                            },
                            "actor": {
                                "$ref": "#/definitions/history-metadata-participant"
                            },
                            "generator": {
                                "$ref": "#/definitions/history-metadata-participant"
                            },
                            "cause": {
                                "$ref": "#/definitions/history-metadata-participant"
                            },
                            "extraData": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "additionalProperties": false
                    },
                    "properties": {
                        "type": "array",
                        "items": {
                            "title": "Entity Property",
                            "type": "object",
                            "properties": {
                                "key": {
                                    "type": "string"
                                },
                                "value": {}
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false
            }
        }
    },
    "definitions": {
        "history-metadata-participant": {
            "title": "History Metadata Participant",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "displayName": {
                    "type": "string"
                },
                "displayNameKey": {
                    "type": "string"
                },
                "type": {
                    "type": "string"
                },
                "avatarUrl": {
                    "type": "string"
                },
                "url": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    返回一个链接到创建的问题。
    {
        "issues": [
            {
                "id": "10000",
                "key": "TST-24",
                "self": "http://www.example.com/jira/rest/api/2/issue/10000"
            },
            {
                "id": "10001",
                "key": "TST-25",
                "self": "http://www.example.com/jira/rest/api/2/issue/10001"
            }
        ],
        "errors": []
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-create-response#",
        "title": "Issue Create Response",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "key": {
                "type": "string"
            },
            "self": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果返回输入无效(例如缺少必填字段,无效字段值,等等)。
    {
        "status": 400,
        "elementErrors": {
            "errorMessages": [
                "Field 'priority' is required"
            ],
            "errors": {}
        },
        "failedElementNumber": 3
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/bulk-operation-error-result#",
        "title": "Bulk Operation Error Result",
        "type": "object",
        "properties": {
            "status": {
                "type": "integer"
            },
            "elementErrors": {
                "title": "Error Collection",
                "type": "object",
                "properties": {
                    "errorMessages": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "errors": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "status": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false
            },
            "failedElementNumber": {
                "type": "integer"
            }
        },
        "additionalProperties": false
    }

返回给定问题关键问题的完整表示。

一个问题JSON由问题的关键,字段的集合,一个连接到工作流程变换分资源,和(可选),支持它的任何字段的HTML渲染的值(例如,如果维基语法的说明或注释启用)。

fields 参数(可多次指定)给出了一个逗号分隔的字段列表中应对包括。 这可以用于检索字段的子集。 一个特定的领域可以通过负前缀就被排除在外。

默认情况下,所有的( *all )字段在此得到发放的资源返回。 注意:做一个JQL搜索时默认的是不同的-默认有刚通航领域( *navigable )。

  • *all - 包括所有领域
  • *navigable - 包括刚刚通航领域
  • summary,comment - 仅包含了总结和评论
  • -comment -包括除注释一切(默认为 *all 为GET-问题)
  • *all,-comment - 除了包含所有评论

该{@code性能参数}类似于{@code场}并指定用逗号分隔的问题属性列表中包含。 不同于{@code领域},属性默认不包括在内。 要包含所有这些发送{@code?属性= *所有}。 您也可以只包括指定的属性或排除与负一些属性( - )标志。

  • {@code *所有} - 包括所有属性
  • {@code *所有,-prop1} - 包括除了{@code为prop1}所有属性
  • {@code为prop1,为prop1} - 包括{@code为prop1}和{@code prop2}性能

JIRA将试图通过找出问题的 issueIdOrKey 路径参数。 这可能是一个问题的id,或问题的关键。 如果无法通过精确匹配中发现的问题,JIRA也将查找问题不区分大小写的方式,或者通过寻找,看看问题是否被感动了。 在这两种情况下,请求将正常进行(302或其他重定向将 退还)。 包含在响应中的关键问题,将表明问题的主要的当前值。

expand 参数用于包括,在默认情况下,响应的部分隐藏。 这可以用于为包括:

  • renderedFields - 以HTML格式字段值
  • names - 每场的显示名称
  • schema - 模式为每个字段描述一种类型的场的
  • transitions - 对给定问题的所有可能的转换
  • operations - 这可能在问题被应用于所有的候选条件操作
  • editmeta - 每个字段可以如何编辑的信息。 它包含字段的架构也是如此。
  • changelog - 给定问题的所有更改历史记录
  • versionedRepresentations -各领域的REST表示。 有些领域可能包含较新版本。 RESET表示屈指可数。 最大的数字始终代表最新的版本。 建议在最新版本被使用。 版本这些字段其提供一个更近的REST表示。 包括后 versionedRepresentations “域”字段变为隐藏。

请求
查询参数
参数 类型 描述
fields

字段列表返回的问题。 默认情况下,所有字段返回。

expand
properties

属性的列表,以返回该问题。 默认情况下没有属性被返回。

回复
  • 状态200 - 应用程序/ JSON
    返回JSON格式的JIRA问题的完整表示。
    {
        "expand": "renderedFields,names,schema,operations,editmeta,changelog,versionedRepresentations",
        "id": "10002",
        "self": "http://www.example.com/jira/rest/api/2/issue/10002",
        "key": "EX-1",
        "fields": {
            "watcher": {
                "self": "http://www.example.com/jira/rest/api/2/issue/EX-1/watchers",
                "isWatching": false,
                "watchCount": 1,
                "watchers": [
                    {
                        "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                        "name": "fred",
                        "displayName": "Fred F. User",
                        "active": false
                    }
                ]
            },
            "attachment": [
                {
                    "self": "http://www.example.com/jira/rest/api/2.0/attachments/10000",
                    "filename": "picture.jpg",
                    "author": {
                        "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                        "name": "fred",
                        "avatarUrls": {
                            "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                            "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                            "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                            "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                        },
                        "displayName": "Fred F. User",
                        "active": false
                    },
                    "created": "2016-09-06T09:48:12.753+0000",
                    "size": 23123,
                    "mimeType": "image/jpeg",
                    "content": "http://www.example.com/jira/attachments/10000",
                    "thumbnail": "http://www.example.com/jira/secure/thumbnail/10000"
                }
            ],
            "sub-tasks": [
                {
                    "id": "10000",
                    "type": {
                        "id": "10000",
                        "name": "",
                        "inward": "Parent",
                        "outward": "Sub-task"
                    },
                    "outwardIssue": {
                        "id": "10003",
                        "key": "EX-2",
                        "self": "http://www.example.com/jira/rest/api/2/issue/EX-2",
                        "fields": {
                            "status": {
                                "iconUrl": "http://www.example.com/jira//images/icons/statuses/open.png",
                                "name": "Open"
                            }
                        }
                    }
                }
            ],
            "description": "example bug report",
            "project": {
                "self": "http://www.example.com/jira/rest/api/2/project/EX",
                "id": "10000",
                "key": "EX",
                "name": "Example",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10000",
                    "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10000",
                    "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10000",
                    "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10000"
                },
                "projectCategory": {
                    "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
                    "id": "10000",
                    "name": "FIRST",
                    "description": "First Project Category"
                }
            },
            "comment": [
                {
                    "self": "http://www.example.com/jira/rest/api/2/issue/10010/comment/10000",
                    "id": "10000",
                    "author": {
                        "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                        "name": "fred",
                        "displayName": "Fred F. User",
                        "active": false
                    },
                    "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.",
                    "updateAuthor": {
                        "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                        "name": "fred",
                        "displayName": "Fred F. User",
                        "active": false
                    },
                    "created": "2016-09-06T09:48:12.346+0000",
                    "updated": "2016-09-06T09:48:12.346+0000",
                    "visibility": {
                        "type": "role",
                        "value": "Administrators"
                    }
                }
            ],
            "issuelinks": [
                {
                    "id": "10001",
                    "type": {
                        "id": "10000",
                        "name": "Dependent",
                        "inward": "depends on",
                        "outward": "is depended by"
                    },
                    "outwardIssue": {
                        "id": "10004L",
                        "key": "PRJ-2",
                        "self": "http://www.example.com/jira/rest/api/2/issue/PRJ-2",
                        "fields": {
                            "status": {
                                "iconUrl": "http://www.example.com/jira//images/icons/statuses/open.png",
                                "name": "Open"
                            }
                        }
                    }
                },
                {
                    "id": "10002",
                    "type": {
                        "id": "10000",
                        "name": "Dependent",
                        "inward": "depends on",
                        "outward": "is depended by"
                    },
                    "inwardIssue": {
                        "id": "10004",
                        "key": "PRJ-3",
                        "self": "http://www.example.com/jira/rest/api/2/issue/PRJ-3",
                        "fields": {
                            "status": {
                                "iconUrl": "http://www.example.com/jira//images/icons/statuses/open.png",
                                "name": "Open"
                            }
                        }
                    }
                }
            ],
            "worklog": [
                {
                    "self": "http://www.example.com/jira/rest/api/2/issue/10010/worklog/10000",
                    "author": {
                        "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                        "name": "fred",
                        "displayName": "Fred F. User",
                        "active": false
                    },
                    "updateAuthor": {
                        "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                        "name": "fred",
                        "displayName": "Fred F. User",
                        "active": false
                    },
                    "comment": "I did some work here.",
                    "updated": "2016-09-06T09:48:12.832+0000",
                    "visibility": {
                        "type": "group",
                        "value": "jira-developers"
                    },
                    "started": "2016-09-06T09:48:12.831+0000",
                    "timeSpent": "3h 20m",
                    "timeSpentSeconds": 12000,
                    "id": "100028",
                    "issueId": "10002"
                }
            ],
            "updated": 1,
            "timetracking": {
                "originalEstimate": "10m",
                "remainingEstimate": "3m",
                "timeSpent": "6m",
                "originalEstimateSeconds": 600,
                "remainingEstimateSeconds": 200,
                "timeSpentSeconds": 400
            }
        },
        "names": {
            "watcher": "watcher",
            "attachment": "attachment",
            "sub-tasks": "sub-tasks",
            "description": "description",
            "project": "project",
            "comment": "comment",
            "issuelinks": "issuelinks",
            "worklog": "worklog",
            "updated": "updated",
            "timetracking": "timetracking"
        },
        "schema": {}
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue#",
        "title": "Issue",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "id": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "key": {
                "type": "string"
            },
            "fields": {
                "type": "object",
                "patternProperties": {
                    ".+": {}
                },
                "additionalProperties": false
            },
            "renderedFields": {
                "type": "object",
                "patternProperties": {
                    ".+": {}
                },
                "additionalProperties": false
            },
            "properties": {
                "title": "Properties",
                "type": "object",
                "properties": {
                    "properties": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "names": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "schema": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "$ref": "#/definitions/json-type"
                    }
                },
                "additionalProperties": false
            },
            "transitions": {
                "type": "array",
                "items": {
                    "title": "Transition",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "to": {
                            "title": "Status",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string"
                                },
                                "statusColor": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "iconUrl": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "id": {
                                    "type": "string"
                                },
                                "statusCategory": {
                                    "title": "Status Category",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string"
                                        },
                                        "id": {
                                            "type": "integer"
                                        },
                                        "key": {
                                            "type": "string"
                                        },
                                        "colorName": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "additionalProperties": false
                        },
                        "fields": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "$ref": "#/definitions/field-meta"
                                }
                            },
                            "additionalProperties": false
                        },
                        "expand": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "operations": {
                "title": "Opsbar",
                "type": "object",
                "properties": {
                    "linkGroups": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/link-group"
                        }
                    }
                },
                "additionalProperties": false
            },
            "editmeta": {
                "title": "Edit Meta",
                "type": "object",
                "properties": {
                    "fields": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "$ref": "#/definitions/field-meta"
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "changelog": {
                "title": "Changelog",
                "type": "object",
                "properties": {
                    "startAt": {
                        "type": "integer"
                    },
                    "maxResults": {
                        "type": "integer"
                    },
                    "total": {
                        "type": "integer"
                    },
                    "histories": {
                        "type": "array",
                        "items": {
                            "title": "Change History",
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "string"
                                },
                                "author": {
                                    "title": "User",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "key": {
                                            "type": "string"
                                        },
                                        "emailAddress": {
                                            "type": "string"
                                        },
                                        "avatarUrls": {
                                            "type": "object",
                                            "patternProperties": {
                                                ".+": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "active": {
                                            "type": "boolean"
                                        },
                                        "timeZone": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "active"
                                    ]
                                },
                                "created": {
                                    "type": "string"
                                },
                                "items": {
                                    "type": "array",
                                    "items": {
                                        "title": "Change Item",
                                        "type": "object",
                                        "properties": {
                                            "field": {
                                                "type": "string"
                                            },
                                            "fieldtype": {
                                                "type": "string"
                                            },
                                            "from": {
                                                "type": "string"
                                            },
                                            "fromString": {
                                                "type": "string"
                                            },
                                            "to": {
                                                "type": "string"
                                            },
                                            "toString": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                },
                                "historyMetadata": {
                                    "title": "History Metadata",
                                    "type": "object",
                                    "properties": {
                                        "type": {
                                            "type": "string"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "descriptionKey": {
                                            "type": "string"
                                        },
                                        "activityDescription": {
                                            "type": "string"
                                        },
                                        "activityDescriptionKey": {
                                            "type": "string"
                                        },
                                        "emailDescription": {
                                            "type": "string"
                                        },
                                        "emailDescriptionKey": {
                                            "type": "string"
                                        },
                                        "actor": {
                                            "$ref": "#/definitions/history-metadata-participant"
                                        },
                                        "generator": {
                                            "$ref": "#/definitions/history-metadata-participant"
                                        },
                                        "cause": {
                                            "$ref": "#/definitions/history-metadata-participant"
                                        },
                                        "extraData": {
                                            "type": "object",
                                            "patternProperties": {
                                                ".+": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false
            },
            "versionedRepresentations": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {}
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "fieldsToInclude": {
                "title": "Included Fields",
                "type": "object"
            }
        },
        "definitions": {
            "field-meta": {
                "title": "Field Meta",
                "type": "object",
                "properties": {
                    "required": {
                        "type": "boolean"
                    },
                    "schema": {
                        "$ref": "#/definitions/json-type"
                    },
                    "name": {
                        "type": "string"
                    },
                    "autoCompleteUrl": {
                        "type": "string"
                    },
                    "hasDefaultValue": {
                        "type": "boolean"
                    },
                    "operations": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "allowedValues": {
                        "type": "array",
                        "items": {}
                    }
                },
                "additionalProperties": false,
                "required": [
                    "required"
                ]
            },
            "history-metadata-participant": {
                "title": "History Metadata Participant",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "displayNameKey": {
                        "type": "string"
                    },
                    "type": {
                        "type": "string"
                    },
                    "avatarUrl": {
                        "type": "string"
                    },
                    "url": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "json-type": {
                "title": "Json Type",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string"
                    },
                    "items": {
                        "type": "string"
                    },
                    "system": {
                        "type": "string"
                    },
                    "custom": {
                        "type": "string"
                    },
                    "customId": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false
            },
            "link-group": {
                "title": "Link Group",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "styleClass": {
                        "type": "string"
                    },
                    "header": {
                        "$ref": "#/definitions/simple-link"
                    },
                    "weight": {
                        "type": "integer"
                    },
                    "links": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/simple-link"
                        }
                    },
                    "groups": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/link-group"
                        }
                    }
                },
                "additionalProperties": false
            },
            "simple-link": {
                "title": "Simple Link",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "styleClass": {
                        "type": "string"
                    },
                    "iconClass": {
                        "type": "string"
                    },
                    "label": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "href": {
                        "type": "string"
                    },
                    "weight": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态404
    返回如果未找到所请求的问题,或者用户没有权限查看。

删除的问题。

如果问题有子任务,则必须设置参数deleteSubtasks = true来删除该问题。 没有它的子任务也被删除您不能删除的问题。

请求
查询参数
参数 类型 描述
deleteSubtasks

true或false表明任何子任务也应删除的字符串。 如果问题没有子任务忽略此参数。 如果问题有子任务,这参数丢失或假的,那么问题将不会被删除,并且将返回一个错误。

回复
  • 状态400
    如果发生错误,返回。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态204
    如果返回成功删除的问题。
  • 状态403
    返回如果主叫用户不具有权限删除的问题。
  • 状态404
    如果这个问题不存在,则返回。

编辑从JSON表示的问题。

这个问题可以通过设置明确的字段值(S)或通过使用一个操作来改变字段的值进行更新。

可以更新,在任一字段参数或更新参数的字段,可以使用被确定 /休息/ API / 2 /问题/ {issueIdOrKey} / editmeta 的资源。
如果一个字段没有被配置为显示在编辑画面上的话,就不会在editmeta,并且如果它被提交会发生场验证错误。

指定“FIELD_ID”:在“域”FIELD_VALUE是“更新”部分中的一个“套”操作的简写。
现场应以“田”或“更新”要么出现,而不是两者。

请求
查询参数
参数 类型 描述
notifyUsers 布尔

默认值:

并发出通知,这个问题已更新到看着它的用户发送电子邮件。 管理员或项目管理员权限才能禁用通知。

{"update":{"summary":[{"set":"Bug in business logic"}],"components":[{"set":""}],"timetracking":[{"edit":{"originalEstimate":"1w 1d","remainingEstimate":"4d"}}],"labels":[{"add":"triaged"},{"remove":"blocker"}]},"fields":{"summary":"This is a shorthand for a set operation on the summary field","customfield_10010":1,"customfield_10000":"This is a shorthand for a set operation on a text custom field"},"historyMetadata":{"type":"myplugin:type","description":"text description","descriptionKey":"plugin.changereason.i18.key","activityDescription":"text description","activityDescriptionKey":"plugin.activity.i18.key","actor":{"id":"tony","displayName":"Tony","type":"mysystem-user","avatarUrl":"http://mysystem/avatar/tony.jpg","url":"http://mysystem/users/tony"},"generator":{"id":"mysystem-1","type":"mysystem-application"},"cause":{"id":"myevent","type":"mysystem-event"},"extraData":{"keyvalue":"extra data","goes":"here"}},"properties":[{"key":"key1","value":'properties' : 'can be set at issue create or update time'},{"key":"key2","value":'and' : 'there can be multiple properties'}]}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/issue-update#",
    "title": "Issue Update",
    "type": "object",
    "properties": {
        "transition": {
            "title": "Transition",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "to": {
                    "title": "Status",
                    "type": "object",
                    "properties": {
                        "statusColor": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "iconUrl": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "statusCategory": {
                            "title": "Status Category",
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer"
                                },
                                "key": {
                                    "type": "string"
                                },
                                "colorName": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "additionalProperties": false
                },
                "fields": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "title": "Field Meta",
                            "type": "object",
                            "properties": {
                                "required": {
                                    "type": "boolean"
                                },
                                "schema": {
                                    "title": "Json Type",
                                    "type": "object",
                                    "properties": {
                                        "type": {
                                            "type": "string"
                                        },
                                        "items": {
                                            "type": "string"
                                        },
                                        "system": {
                                            "type": "string"
                                        },
                                        "custom": {
                                            "type": "string"
                                        },
                                        "customId": {
                                            "type": "integer"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "name": {
                                    "type": "string"
                                },
                                "autoCompleteUrl": {
                                    "type": "string"
                                },
                                "hasDefaultValue": {
                                    "type": "boolean"
                                },
                                "operations": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "allowedValues": {
                                    "type": "array",
                                    "items": {}
                                }
                            },
                            "additionalProperties": false,
                            "required": [
                                "required"
                            ]
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        },
        "fields": {
            "type": "object",
            "patternProperties": {
                ".+": {}
            },
            "additionalProperties": false
        },
        "update": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "array",
                    "items": {
                        "title": "Field Operation",
                        "type": "object"
                    }
                }
            },
            "additionalProperties": false
        },
        "historyMetadata": {
            "title": "History Metadata",
            "type": "object",
            "properties": {
                "type": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "descriptionKey": {
                    "type": "string"
                },
                "activityDescription": {
                    "type": "string"
                },
                "activityDescriptionKey": {
                    "type": "string"
                },
                "emailDescription": {
                    "type": "string"
                },
                "emailDescriptionKey": {
                    "type": "string"
                },
                "actor": {
                    "$ref": "#/definitions/history-metadata-participant"
                },
                "generator": {
                    "$ref": "#/definitions/history-metadata-participant"
                },
                "cause": {
                    "$ref": "#/definitions/history-metadata-participant"
                },
                "extraData": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        },
        "properties": {
            "type": "array",
            "items": {
                "title": "Entity Property",
                "type": "object",
                "properties": {
                    "key": {
                        "type": "string"
                    },
                    "value": {}
                },
                "additionalProperties": false
            }
        }
    },
    "definitions": {
        "history-metadata-participant": {
            "title": "History Metadata Participant",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "displayName": {
                    "type": "string"
                },
                "displayNameKey": {
                    "type": "string"
                },
                "type": {
                    "type": "string"
                },
                "avatarUrl": {
                    "type": "string"
                },
                "url": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    },
    "additionalProperties": false
}
回复
  • 状态400
    返回如果请求的问题,更新失败。
  • 状态204
    如果它成功更新的问题返回。
  • 状态403
    返回如果用户没有权限禁用用户通知。

分配问题给用户。 你可以使用这个资源分配的问题,当用户提交请求具有分配权限,但不能编辑问题的权限。 如果名字是“-1”自动受让人被使用。 一个空的名字将删除受让人。

请求
{
    "name": "harry"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/user#",
    "title": "User",
    "type": "object",
    "properties": {
        "key": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "emailAddress": {
            "type": "string"
        },
        "avatarUrls": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "string",
                    "format": "uri"
                }
            },
            "additionalProperties": false
        },
        "displayName": {
            "type": "string"
        },
        "active": {
            "type": "boolean"
        },
        "timeZone": {
            "type": "string"
        },
        "locale": {
            "type": "string"
        },
        "groups": {
            "$ref": "#/definitions/simple-list-wrapper"
        },
        "applicationRoles": {
            "$ref": "#/definitions/simple-list-wrapper"
        }
    },
    "definitions": {
        "simple-list-wrapper": {
            "title": "Simple List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "title": "Group",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size"
            ]
        }
    },
    "additionalProperties": false,
    "required": [
        "active"
    ]
}
回复
  • 状态400
    如果没有与接收到的用户表示一个问题返回。
  • 状态401
    返回如果主叫用户不具有权限分配的问题。
  • 状态204
    如果发行成功返回分配。
  • 状态404
    如果任一问题,或者用户不存在退货。

返回一个问题的所有意见。

结果可以通过“创造”领域,这意味着增加了一个注释的日期进行排序。

请求
查询参数
参数 类型 描述
startAt

页面偏移,如果不指定,则默认为0

maxResults INT

在页面上的许多结果应被包括在内。 默认为50。

orderBy

结果的排序。

expand

可选标志:renderedBody(提供HTML渲染体)

回复
  • 状态200 - 应用程序/ JSON
    返回与此问题相关,具有计数和分页信息意见的集合。
    {
        "startAt": 0,
        "maxResults": 1,
        "total": 1,
        "comments": [
            {
                "self": "http://www.example.com/jira/rest/api/2/issue/10010/comment/10000",
                "id": "10000",
                "author": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "displayName": "Fred F. User",
                    "active": false
                },
                "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.",
                "updateAuthor": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "displayName": "Fred F. User",
                    "active": false
                },
                "created": "2016-09-06T09:48:12.346+0000",
                "updated": "2016-09-06T09:48:12.346+0000",
                "visibility": {
                    "type": "role",
                    "value": "Administrators"
                }
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/comments-with-pagination#",
        "title": "Comments With Pagination",
        "type": "object",
        "properties": {
            "startAt": {
                "type": "integer"
            },
            "maxResults": {
                "type": "integer"
            },
            "total": {
                "type": "integer"
            },
            "comments": {
                "type": "array",
                "items": {
                    "title": "Comment",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "author": {
                            "$ref": "#/definitions/user"
                        },
                        "body": {
                            "type": "string"
                        },
                        "renderedBody": {
                            "type": "string"
                        },
                        "updateAuthor": {
                            "$ref": "#/definitions/user"
                        },
                        "created": {
                            "type": "string"
                        },
                        "updated": {
                            "type": "string"
                        },
                        "visibility": {
                            "title": "Visibility",
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string",
                                    "enum": [
                                        "group",
                                        "role"
                                    ]
                                },
                                "value": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "properties": {
                            "type": "array",
                            "items": {
                                "title": "Entity Property",
                                "type": "object",
                                "properties": {
                                    "key": {
                                        "type": "string"
                                    },
                                    "value": {}
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "definitions": {
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果给定id /关键问题不存在,或者如果当前身份验证的用户没有权限查看它返回。

增加了一个问题,一个新的注释。

请求
查询参数
参数 类型 描述
expand

可选标志:renderedBody(提供HTML渲染体)

{
    "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.",
    "visibility": {
        "type": "role",
        "value": "Administrators"
    }
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/comment#",
    "title": "Comment",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "author": {
            "$ref": "#/definitions/user"
        },
        "body": {
            "type": "string"
        },
        "renderedBody": {
            "type": "string"
        },
        "updateAuthor": {
            "$ref": "#/definitions/user"
        },
        "created": {
            "type": "string"
        },
        "updated": {
            "type": "string"
        },
        "visibility": {
            "title": "Visibility",
            "type": "object",
            "properties": {
                "type": {
                    "type": "string",
                    "enum": [
                        "group",
                        "role"
                    ]
                },
                "value": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "properties": {
            "type": "array",
            "items": {
                "title": "Entity Property",
                "type": "object",
                "properties": {
                    "key": {
                        "type": "string"
                    },
                    "value": {}
                },
                "additionalProperties": false
            }
        }
    },
    "definitions": {
        "user": {
            "title": "User",
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "key": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态201
    如果返回添加成功
    {
        "self": "http://www.example.com/jira/rest/api/2/issue/10010/comment/10000",
        "id": "10000",
        "author": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.",
        "updateAuthor": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "created": "2016-09-06T09:48:12.346+0000",
        "updated": "2016-09-06T09:48:12.346+0000",
        "visibility": {
            "type": "role",
            "value": "Administrators"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/comment#",
        "title": "Comment",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "id": {
                "type": "string"
            },
            "author": {
                "$ref": "#/definitions/user"
            },
            "body": {
                "type": "string"
            },
            "renderedBody": {
                "type": "string"
            },
            "updateAuthor": {
                "$ref": "#/definitions/user"
            },
            "created": {
                "type": "string"
            },
            "updated": {
                "type": "string"
            },
            "visibility": {
                "title": "Visibility",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "group",
                            "role"
                        ]
                    },
                    "value": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "properties": {
                "type": "array",
                "items": {
                    "title": "Entity Property",
                    "type": "object",
                    "properties": {
                        "key": {
                            "type": "string"
                        },
                        "value": {}
                    },
                    "additionalProperties": false
                }
            }
        },
        "definitions": {
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果返回输入无效(例如缺少必填字段,无效值,等等)。

返回一个注释。

请求
查询参数
参数 类型 描述
expand

可选标志:renderedBody(提供HTML渲染体)

回复
  • 状态200 - 应用程序/ JSON
    返回JSON格式的JIRA注释的完整表示。
    {
        "self": "http://www.example.com/jira/rest/api/2/issue/10010/comment/10000",
        "id": "10000",
        "author": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.",
        "updateAuthor": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "created": "2016-09-06T09:48:12.346+0000",
        "updated": "2016-09-06T09:48:12.346+0000",
        "visibility": {
            "type": "role",
            "value": "Administrators"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/comments-with-pagination#",
        "title": "Comments With Pagination",
        "type": "object",
        "properties": {
            "startAt": {
                "type": "integer"
            },
            "maxResults": {
                "type": "integer"
            },
            "total": {
                "type": "integer"
            },
            "comments": {
                "type": "array",
                "items": {
                    "title": "Comment",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "author": {
                            "$ref": "#/definitions/user"
                        },
                        "body": {
                            "type": "string"
                        },
                        "renderedBody": {
                            "type": "string"
                        },
                        "updateAuthor": {
                            "$ref": "#/definitions/user"
                        },
                        "created": {
                            "type": "string"
                        },
                        "updated": {
                            "type": "string"
                        },
                        "visibility": {
                            "title": "Visibility",
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string",
                                    "enum": [
                                        "group",
                                        "role"
                                    ]
                                },
                                "value": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "properties": {
                            "type": "array",
                            "items": {
                                "title": "Entity Property",
                                "type": "object",
                                "properties": {
                                    "key": {
                                        "type": "string"
                                    },
                                    "value": {}
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "definitions": {
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态404
    返回如果未找到所请求的评论,或者用户没有权限查看。

更新使用它的JSON表示现有注释。

请求
查询参数
参数 类型 描述
expand

可选标志:renderedBody(提供HTML渲染体)

{
    "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.",
    "visibility": {
        "type": "role",
        "value": "Administrators"
    }
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/comment#",
    "title": "Comment",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "author": {
            "$ref": "#/definitions/user"
        },
        "body": {
            "type": "string"
        },
        "renderedBody": {
            "type": "string"
        },
        "updateAuthor": {
            "$ref": "#/definitions/user"
        },
        "created": {
            "type": "string"
        },
        "updated": {
            "type": "string"
        },
        "visibility": {
            "title": "Visibility",
            "type": "object",
            "properties": {
                "type": {
                    "type": "string",
                    "enum": [
                        "group",
                        "role"
                    ]
                },
                "value": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "properties": {
            "type": "array",
            "items": {
                "title": "Entity Property",
                "type": "object",
                "properties": {
                    "key": {
                        "type": "string"
                    },
                    "value": {}
                },
                "additionalProperties": false
            }
        }
    },
    "definitions": {
        "user": {
            "title": "User",
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "key": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    如果返回更新成功
    {
        "self": "http://www.example.com/jira/rest/api/2/issue/10010/comment/10000",
        "id": "10000",
        "author": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.",
        "updateAuthor": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "created": "2016-09-06T09:48:12.346+0000",
        "updated": "2016-09-06T09:48:12.346+0000",
        "visibility": {
            "type": "role",
            "value": "Administrators"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/comment#",
        "title": "Comment",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "id": {
                "type": "string"
            },
            "author": {
                "$ref": "#/definitions/user"
            },
            "body": {
                "type": "string"
            },
            "renderedBody": {
                "type": "string"
            },
            "updateAuthor": {
                "$ref": "#/definitions/user"
            },
            "created": {
                "type": "string"
            },
            "updated": {
                "type": "string"
            },
            "visibility": {
                "title": "Visibility",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "group",
                            "role"
                        ]
                    },
                    "value": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "properties": {
                "type": "array",
                "items": {
                    "title": "Entity Property",
                    "type": "object",
                    "properties": {
                        "key": {
                            "type": "string"
                        },
                        "value": {}
                    },
                    "additionalProperties": false
                }
            }
        },
        "definitions": {
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果返回输入无效(例如缺少必填字段,无效值,等等)。

删除现有评论。

回复
  • 状态400
    如果返回输入无效(例如缺少必填字段,无效值,等等)。
  • 状态204
    如果返回删除成功

返回编辑的问题元数据。

在editmeta字段对应于编辑屏幕的问题领域。 不能在屏幕上的字段将不会在editmeta。

回复
  • 状态200 - 应用程序/ JSON
    返回包含地图FieldBeans为当前用户可编辑的字段的响应。
    {
        "fields": {
            "summary": {
                "required": false,
                "schema": {
                    "type": "array",
                    "items": "option",
                    "custom": "com.atlassian.jira.plugin.system.customfieldtypes:multiselect",
                    "customId": 10001
                },
                "name": "My Multi Select",
                "hasDefaultValue": false,
                "operations": [
                    "set",
                    "add"
                ],
                "allowedValues": [
                    "red",
                    "blue"
                ]
            }
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/edit-meta#",
        "title": "Edit Meta",
        "type": "object",
        "properties": {
            "fields": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Field Meta",
                        "type": "object",
                        "properties": {
                            "required": {
                                "type": "boolean"
                            },
                            "schema": {
                                "title": "Json Type",
                                "type": "object",
                                "properties": {
                                    "type": {
                                        "type": "string"
                                    },
                                    "items": {
                                        "type": "string"
                                    },
                                    "system": {
                                        "type": "string"
                                    },
                                    "custom": {
                                        "type": "string"
                                    },
                                    "customId": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "name": {
                                "type": "string"
                            },
                            "autoCompleteUrl": {
                                "type": "string"
                            },
                            "hasDefaultValue": {
                                "type": "boolean"
                            },
                            "operations": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "allowedValues": {
                                "type": "array",
                                "items": {}
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "required"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态404
    或者返回如果未找到所请求的问题的用户没有权限查看。

发送一个通知(电子邮件),以在所述请求中定义的列表或收件人。

请求
{
    "subject": "Duis eu justo eget augue iaculis fermentum.",
    "textBody": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.",
    "htmlBody": "Lorem ipsum <strong>dolor</strong> sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.",
    "to": {
        "reporter": false,
        "assignee": false,
        "watchers": true,
        "voters": true,
        "users": [
            {
                "name": "fred",
                "active": false
            }
        ],
        "groups": [
            {
                "name": "notification-group",
                "self": "http://www.example.com/jira/rest/api/2/group?groupname=notification-group"
            }
        ]
    },
    "restrict": {
        "groups": [
            {
                "name": "notification-group",
                "self": "http://www.example.com/jira/rest/api/2/group?groupname=notification-group"
            }
        ],
        "permissions": [
            {
                "id": "10",
                "key": "BROWSE"
            }
        ]
    }
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/notification#",
    "title": "Notification",
    "type": "object",
    "properties": {
        "subject": {
            "type": "string"
        },
        "textBody": {
            "type": "string"
        },
        "htmlBody": {
            "type": "string"
        },
        "to": {
            "title": "To",
            "type": "object",
            "properties": {
                "reporter": {
                    "type": "boolean"
                },
                "assignee": {
                    "type": "boolean"
                },
                "watchers": {
                    "type": "boolean"
                },
                "voters": {
                    "type": "boolean"
                },
                "users": {
                    "type": "array",
                    "items": {
                        "title": "User",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            },
                            "key": {
                                "type": "string"
                            },
                            "emailAddress": {
                                "type": "string"
                            },
                            "avatarUrls": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "displayName": {
                                "type": "string"
                            },
                            "active": {
                                "type": "boolean"
                            },
                            "timeZone": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "active"
                        ]
                    }
                },
                "groups": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/group"
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "reporter",
                "assignee",
                "watchers",
                "voters"
            ]
        },
        "restrict": {
            "title": "Restrict",
            "type": "object",
            "properties": {
                "groups": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/group"
                    }
                },
                "permissions": {
                    "type": "array",
                    "items": {
                        "title": "Permission",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "key": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false
        }
    },
    "definitions": {
        "group": {
            "title": "Group",
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    },
    "additionalProperties": false
}
回复
  • 状态400
    如果返回输入无效(例如缺少必填字段,无效值,等等)。
  • 状态204
    回到如果增加了邮件队列成功
  • 状态403
    返回的外发邮件被禁用或没有SMTP服务器的定义。

代表在这个问题上的远程问题链接休息子资源。

请求
查询参数
参数 类型 描述
globalId

要返回的远程问题链接的ID。 如果返回null(未提供)的问题的所有远程链接。

对于问题链接字段的fullexplanation请参考 https://developer.atlassian.com/display/JIRADEV/Fields+in+Remote+Issue+Links

回复
  • 状态200 - 应用程序/ JSON
    对本期远程问题链接的信息。
    [
        {
            "id": 10000,
            "self": "http://www.example.com/jira/rest/api/issue/MKY-1/remotelink/10000",
            "globalId": "system=http://www.mycompany.com/support&id=1",
            "application": {
                "type": "com.acme.tracker",
                "name": "My Acme Tracker"
            },
            "relationship": "causes",
            "object": {
                "url": "http://www.mycompany.com/support?id=1",
                "title": "TSTSUP-111",
                "summary": "Crazy customer support issue",
                "icon": {
                    "url16x16": "http://www.mycompany.com/support/ticket.png",
                    "title": "Support Ticket"
                },
                "status": {
                    "resolved": true,
                    "icon": {
                        "url16x16": "http://www.mycompany.com/support/resolved.png",
                        "title": "Case Closed",
                        "link": "http://www.mycompany.com/support?id=1&details=closed"
                    }
                }
            }
        },
        {
            "id": 10001,
            "self": "http://www.example.com/jira/rest/api/issue/MKY-1/remotelink/10001",
            "globalId": "system=http://www.anothercompany.com/tester&id=1234",
            "application": {
                "type": "com.acme.tester",
                "name": "My Acme Tester"
            },
            "relationship": "is tested by",
            "object": {
                "url": "http://www.anothercompany.com/tester/testcase/1234",
                "title": "Test Case #1234",
                "summary": "Test that the submit button saves the thing",
                "icon": {
                    "url16x16": "http://www.anothercompany.com/tester/images/testcase.gif",
                    "title": "Test Case"
                },
                "status": {
                    "resolved": false,
                    "icon": {
                        "url16x16": "http://www.anothercompany.com/tester/images/person/fred.gif",
                        "title": "Tested by Fred Jones",
                        "link": "http://www.anothercompany.com/tester/person?username=fred"
                    }
                }
            }
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-remote-issue-link#",
        "title": "List of Remote Issue Link",
        "type": "array",
        "items": {
            "title": "Remote Issue Link",
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "globalId": {
                    "type": "string"
                },
                "application": {
                    "title": "Application",
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "relationship": {
                    "type": "string"
                },
                "object": {
                    "title": "Remote Object",
                    "type": "object",
                    "properties": {
                        "url": {
                            "type": "string"
                        },
                        "title": {
                            "type": "string"
                        },
                        "summary": {
                            "type": "string"
                        },
                        "icon": {
                            "$ref": "#/definitions/icon"
                        },
                        "status": {
                            "title": "Status",
                            "type": "object",
                            "properties": {
                                "resolved": {
                                    "type": "boolean"
                                },
                                "icon": {
                                    "$ref": "#/definitions/icon"
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        },
        "definitions": {
            "icon": {
                "title": "Icon",
                "type": "object",
                "properties": {
                    "url16x16": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "link": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            }
        }
    }
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    如果返回调用用户没有权限查看远程问题链接,或者如果问题链接被禁用。
  • 状态404
    如果不存在问题或远程问题链接返回。

创建或更新从JSON表示远程问题链接。 如果提供了globalId和远程问题链路与globalId存在,远程问题链路被更新。 否则,将创建远程问题链接。

请求
{
    "globalId": "system=http://www.mycompany.com/support&id=1",
    "application": {
        "type": "com.acme.tracker",
        "name": "My Acme Tracker"
    },
    "relationship": "causes",
    "object": {
        "url": "http://www.mycompany.com/support?id=1",
        "title": "TSTSUP-111",
        "summary": "Crazy customer support issue",
        "icon": {
            "url16x16": "http://www.mycompany.com/support/ticket.png",
            "title": "Support Ticket"
        },
        "status": {
            "resolved": true,
            "icon": {
                "url16x16": "http://www.mycompany.com/support/resolved.png",
                "title": "Case Closed",
                "link": "http://www.mycompany.com/support?id=1&details=closed"
            }
        }
    }
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/remote-issue-link-create-or-update-request#",
    "title": "Remote Issue Link Create Or Update Request",
    "type": "object",
    "properties": {
        "globalId": {
            "type": "string"
        },
        "application": {
            "title": "Application",
            "type": "object",
            "properties": {
                "type": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "relationship": {
            "type": "string"
        },
        "object": {
            "title": "Remote Object",
            "type": "object",
            "properties": {
                "url": {
                    "type": "string"
                },
                "title": {
                    "type": "string"
                },
                "summary": {
                    "type": "string"
                },
                "icon": {
                    "$ref": "#/definitions/icon"
                },
                "status": {
                    "title": "Status",
                    "type": "object",
                    "properties": {
                        "resolved": {
                            "type": "boolean"
                        },
                        "icon": {
                            "$ref": "#/definitions/icon"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        }
    },
    "definitions": {
        "icon": {
            "title": "Icon",
            "type": "object",
            "properties": {
                "url16x16": {
                    "type": "string"
                },
                "title": {
                    "type": "string"
                },
                "link": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    返回一个链接到创建/更新远程问题链接。
    {
        "id": 10000,
        "self": "http://www.example.com/jira/rest/api/issue/MKY-1/remotelink/10000"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/remote-issue-link-create-or-update-response#",
        "title": "Remote Issue Link Create Or Update Response",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "self": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果返回输入无效(例如缺少必填字段,无效值,等等)。
    {
        "errorMessages": [],
        "errors": {
            "title": "'title' is required."
        }
    }
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    如果返回调用用户没有权限创建/更新远程问题链接,或者如果问题挂钩是禁用的。

删除与在这个问题上给定的全局ID的远程问题链接。

请求
查询参数
参数 类型 描述
globalId

远程问题链接的全局ID

回复
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态204
    返回如果远程问题链接被成功摘除。
  • 状态403
    返回如果调用用户没有权限删除远程连接问题,或者如果问题挂钩是禁用的。
  • 状态404
    如果不存在问题或远程问题链接返回。

获取关于这一问题给定id远程问题链接。

回复
  • 状态200 - 应用程序/ JSON
    给定ID的远程问题链接信息。
    {
        "id": 10000,
        "self": "http://www.example.com/jira/rest/api/issue/MKY-1/remotelink/10000",
        "globalId": "system=http://www.mycompany.com/support&id=1",
        "application": {
            "type": "com.acme.tracker",
            "name": "My Acme Tracker"
        },
        "relationship": "causes",
        "object": {
            "url": "http://www.mycompany.com/support?id=1",
            "title": "TSTSUP-111",
            "summary": "Crazy customer support issue",
            "icon": {
                "url16x16": "http://www.mycompany.com/support/ticket.png",
                "title": "Support Ticket"
            },
            "status": {
                "resolved": true,
                "icon": {
                    "url16x16": "http://www.mycompany.com/support/resolved.png",
                    "title": "Case Closed",
                    "link": "http://www.mycompany.com/support?id=1&details=closed"
                }
            }
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/remote-issue-link#",
        "title": "Remote Issue Link",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "globalId": {
                "type": "string"
            },
            "application": {
                "title": "Application",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "relationship": {
                "type": "string"
            },
            "object": {
                "title": "Remote Object",
                "type": "object",
                "properties": {
                    "url": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "summary": {
                        "type": "string"
                    },
                    "icon": {
                        "$ref": "#/definitions/icon"
                    },
                    "status": {
                        "title": "Status",
                        "type": "object",
                        "properties": {
                            "resolved": {
                                "type": "boolean"
                            },
                            "icon": {
                                "$ref": "#/definitions/icon"
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "icon": {
                "title": "Icon",
                "type": "object",
                "properties": {
                    "url16x16": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "link": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果LINKID是不是有效的数字,或者如果给定id远程问题链接不属于特定问题。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    如果返回调用用户没有权限查看远程连接问题,或者如果问题挂钩是禁用的。
  • 状态404
    如果不存在问题或远程问题链接返回。

从更新JSON表示远程问题链接。 没有提供任何字段都设置为null。

请求
{
    "globalId": "system=http://www.mycompany.com/support&id=1",
    "application": {
        "type": "com.acme.tracker",
        "name": "My Acme Tracker"
    },
    "relationship": "causes",
    "object": {
        "url": "http://www.mycompany.com/support?id=1",
        "title": "TSTSUP-111",
        "summary": "Crazy customer support issue",
        "icon": {
            "url16x16": "http://www.mycompany.com/support/ticket.png",
            "title": "Support Ticket"
        },
        "status": {
            "resolved": true,
            "icon": {
                "url16x16": "http://www.mycompany.com/support/resolved.png",
                "title": "Case Closed",
                "link": "http://www.mycompany.com/support?id=1&details=closed"
            }
        }
    }
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/remote-issue-link-create-or-update-request#",
    "title": "Remote Issue Link Create Or Update Request",
    "type": "object",
    "properties": {
        "globalId": {
            "type": "string"
        },
        "application": {
            "title": "Application",
            "type": "object",
            "properties": {
                "type": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "relationship": {
            "type": "string"
        },
        "object": {
            "title": "Remote Object",
            "type": "object",
            "properties": {
                "url": {
                    "type": "string"
                },
                "title": {
                    "type": "string"
                },
                "summary": {
                    "type": "string"
                },
                "icon": {
                    "$ref": "#/definitions/icon"
                },
                "status": {
                    "title": "Status",
                    "type": "object",
                    "properties": {
                        "resolved": {
                            "type": "boolean"
                        },
                        "icon": {
                            "$ref": "#/definitions/icon"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        }
    },
    "definitions": {
        "icon": {
            "title": "Icon",
            "type": "object",
            "properties": {
                "url16x16": {
                    "type": "string"
                },
                "title": {
                    "type": "string"
                },
                "link": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    },
    "additionalProperties": false
}
回复
  • 状态400
    如果返回输入无效(例如缺少必填字段,无效值,等等)。
    {
        "errorMessages": [],
        "errors": {
            "title": "'title' is required."
        }
    }
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态204
    返回如果远程问题链接已成功更新。
  • 状态403
    如果返回调用用户没有权限更新远程问题链接,或者如果问题挂钩是禁用的。

删除与在这个问题上给定id远程问题链接。

回复
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态204
    返回如果远程问题链接被成功摘除。
  • 状态403
    返回如果调用用户没有权限删除远程连接问题,或者如果问题挂钩是禁用的。
  • 状态404
    如果不存在问题或远程问题链接返回。

由当前用户获取针对此问题可能的转换的列表,以及被要求的字段和它们的类型沿着。

字段将仅在返回 expand=transitions.fields

在元数据字段对应于过渡屏幕过渡字段。 不能在屏幕上的字段不会在元数据。

请求
查询参数
参数 类型 描述
transitionId
回复
  • 状态200 - 应用程序/ JSON
    返回指定问题的可能的过渡和执行过渡所需的字段的完整表示。
    {
        "expand": "transitions",
        "transitions": [
            {
                "id": "2",
                "name": "Close Issue",
                "to": {
                    "self": "http://localhost:8090/jira/rest/api/2.0/status/10000",
                    "description": "The issue is currently being worked on.",
                    "iconUrl": "http://localhost:8090/jira/images/icons/progress.gif",
                    "name": "In Progress",
                    "id": "10000",
                    "statusCategory": {
                        "self": "http://localhost:8090/jira/rest/api/2.0/statuscategory/1",
                        "id": 1,
                        "key": "in-flight",
                        "colorName": "yellow",
                        "name": "In Progress"
                    }
                },
                "fields": {
                    "summary": {
                        "required": false,
                        "schema": {
                            "type": "array",
                            "items": "option",
                            "custom": "com.atlassian.jira.plugin.system.customfieldtypes:multiselect",
                            "customId": 10001
                        },
                        "name": "My Multi Select",
                        "hasDefaultValue": false,
                        "operations": [
                            "set",
                            "add"
                        ],
                        "allowedValues": [
                            "red",
                            "blue"
                        ]
                    }
                }
            },
            {
                "id": "711",
                "name": "QA Review",
                "to": {
                    "self": "http://localhost:8090/jira/rest/api/2.0/status/5",
                    "description": "The issue is closed.",
                    "iconUrl": "http://localhost:8090/jira/images/icons/closed.gif",
                    "name": "Closed",
                    "id": "5",
                    "statusCategory": {
                        "self": "http://localhost:8090/jira/rest/api/2.0/statuscategory/9",
                        "id": 9,
                        "key": "completed",
                        "colorName": "green"
                    }
                },
                "fields": {
                    "summary": {
                        "required": false,
                        "schema": {
                            "type": "array",
                            "items": "option",
                            "custom": "com.atlassian.jira.plugin.system.customfieldtypes:multiselect",
                            "customId": 10001
                        },
                        "name": "My Multi Select",
                        "hasDefaultValue": false,
                        "operations": [
                            "set",
                            "add"
                        ],
                        "allowedValues": [
                            "red",
                            "blue"
                        ]
                    },
                    "colour": {
                        "required": false,
                        "schema": {
                            "type": "array",
                            "items": "option",
                            "custom": "com.atlassian.jira.plugin.system.customfieldtypes:multiselect",
                            "customId": 10001
                        },
                        "name": "My Multi Select",
                        "hasDefaultValue": false,
                        "operations": [
                            "set",
                            "add"
                        ],
                        "allowedValues": [
                            "red",
                            "blue"
                        ]
                    }
                }
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/transitions-meta#",
        "title": "Transitions Meta",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "transitions": {
                "type": "array",
                "items": {
                    "title": "Transition",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "to": {
                            "title": "Status",
                            "type": "object",
                            "properties": {
                                "self": {
                                    "type": "string"
                                },
                                "statusColor": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "iconUrl": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "id": {
                                    "type": "string"
                                },
                                "statusCategory": {
                                    "title": "Status Category",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string"
                                        },
                                        "id": {
                                            "type": "integer"
                                        },
                                        "key": {
                                            "type": "string"
                                        },
                                        "colorName": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "additionalProperties": false
                        },
                        "fields": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "title": "Field Meta",
                                    "type": "object",
                                    "properties": {
                                        "required": {
                                            "type": "boolean"
                                        },
                                        "schema": {
                                            "title": "Json Type",
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                },
                                                "items": {
                                                    "type": "string"
                                                },
                                                "system": {
                                                    "type": "string"
                                                },
                                                "custom": {
                                                    "type": "string"
                                                },
                                                "customId": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "autoCompleteUrl": {
                                            "type": "string"
                                        },
                                        "hasDefaultValue": {
                                            "type": "boolean"
                                        },
                                        "operations": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        },
                                        "allowedValues": {
                                            "type": "array",
                                            "items": {}
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "required"
                                    ]
                                }
                            },
                            "additionalProperties": false
                        },
                        "expand": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态404
    或者返回如果未找到所请求的问题的用户没有权限查看。

执行对一个问题的过渡。 当执行过渡您可以更新或设置其他的问题领域。

可以在跃迁进行设置,在任一字段参数或更新参数的字段可以用来确定 /rest/api/2/issue/{issueIdOrKey}/transitions?expand=transitions.fields 资源。 如果字段没有被配置为显示在过渡屏幕上,那么它将不会在过渡元数据,并且如果它被提交会发生场验证错误。

请求
{
    "update": {
        "comment": [
            {
                "add": {
                    "body": "Bug has been fixed."
                }
            }
        ]
    },
    "fields": {
        "assignee": {
            "name": "bob"
        },
        "resolution": {
            "name": "Fixed"
        }
    },
    "transition": {
        "id": "5"
    },
    "historyMetadata": {
        "type": "myplugin:type",
        "description": "text description",
        "descriptionKey": "plugin.changereason.i18.key",
        "activityDescription": "text description",
        "activityDescriptionKey": "plugin.activity.i18.key",
        "actor": {
            "id": "tony",
            "displayName": "Tony",
            "type": "mysystem-user",
            "avatarUrl": "http://mysystem/avatar/tony.jpg",
            "url": "http://mysystem/users/tony"
        },
        "generator": {
            "id": "mysystem-1",
            "type": "mysystem-application"
        },
        "cause": {
            "id": "myevent",
            "type": "mysystem-event"
        },
        "extraData": {
            "keyvalue": "extra data",
            "goes": "here"
        }
    }
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/issue-update#",
    "title": "Issue Update",
    "type": "object",
    "properties": {
        "transition": {
            "title": "Transition",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "to": {
                    "title": "Status",
                    "type": "object",
                    "properties": {
                        "statusColor": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "iconUrl": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "statusCategory": {
                            "title": "Status Category",
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "integer"
                                },
                                "key": {
                                    "type": "string"
                                },
                                "colorName": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "additionalProperties": false
                },
                "fields": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "title": "Field Meta",
                            "type": "object",
                            "properties": {
                                "required": {
                                    "type": "boolean"
                                },
                                "schema": {
                                    "title": "Json Type",
                                    "type": "object",
                                    "properties": {
                                        "type": {
                                            "type": "string"
                                        },
                                        "items": {
                                            "type": "string"
                                        },
                                        "system": {
                                            "type": "string"
                                        },
                                        "custom": {
                                            "type": "string"
                                        },
                                        "customId": {
                                            "type": "integer"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "name": {
                                    "type": "string"
                                },
                                "autoCompleteUrl": {
                                    "type": "string"
                                },
                                "hasDefaultValue": {
                                    "type": "boolean"
                                },
                                "operations": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                "allowedValues": {
                                    "type": "array",
                                    "items": {}
                                }
                            },
                            "additionalProperties": false,
                            "required": [
                                "required"
                            ]
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        },
        "fields": {
            "type": "object",
            "patternProperties": {
                ".+": {}
            },
            "additionalProperties": false
        },
        "update": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "array",
                    "items": {
                        "title": "Field Operation",
                        "type": "object"
                    }
                }
            },
            "additionalProperties": false
        },
        "historyMetadata": {
            "title": "History Metadata",
            "type": "object",
            "properties": {
                "type": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "descriptionKey": {
                    "type": "string"
                },
                "activityDescription": {
                    "type": "string"
                },
                "activityDescriptionKey": {
                    "type": "string"
                },
                "emailDescription": {
                    "type": "string"
                },
                "emailDescriptionKey": {
                    "type": "string"
                },
                "actor": {
                    "$ref": "#/definitions/history-metadata-participant"
                },
                "generator": {
                    "$ref": "#/definitions/history-metadata-participant"
                },
                "cause": {
                    "$ref": "#/definitions/history-metadata-participant"
                },
                "extraData": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        },
        "properties": {
            "type": "array",
            "items": {
                "title": "Entity Property",
                "type": "object",
                "properties": {
                    "key": {
                        "type": "string"
                    },
                    "value": {}
                },
                "additionalProperties": false
            }
        }
    },
    "definitions": {
        "history-metadata-participant": {
            "title": "History Metadata Participant",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "displayName": {
                    "type": "string"
                },
                "displayNameKey": {
                    "type": "string"
                },
                "type": {
                    "type": "string"
                },
                "avatarUrl": {
                    "type": "string"
                },
                "url": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    },
    "additionalProperties": false
}
回复
  • 状态400
    如果没有指定的过渡。
  • 状态204
    如果返回的转变是成功的。
  • 状态404
    这个问题不存在,或者用户没有权限查看它

从问题中删除您的投票。 (即“unvote”)

回复
  • 状态204
    没有返回成功。
  • 状态404
    如果用户不能删除任何理由投票返回。 (用户没有对这个问题进行投票,用户是记者,投票被禁止,这个问题不存在,等等)

投你的票赞成的一个问题。

回复
  • 状态204
    没有返回成功。
  • 状态404
    返回如果用户不能投票给任何理由。 (用户是记者,用户没有权限进行投票,表决是在实例禁用,该问题不存在,等等)

代表在这个问题上,选民休息子资源。

回复
  • 状态200 - 应用程序/ JSON
    关于本期投票信息。
    {
        "self": "http://www.example.com/jira/rest/api/issue/MKY-1/votes",
        "votes": 24,
        "hasVoted": true,
        "voters": [
            {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                    "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                    "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                    "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                },
                "displayName": "Fred F. User",
                "active": false
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/vote#",
        "title": "Vote",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "votes": {
                "type": "integer"
            },
            "hasVoted": {
                "type": "boolean"
            },
            "voters": {}
        },
        "additionalProperties": false,
        "required": [
            "votes",
            "hasVoted"
        ]
    }
  • 状态404
    如果用户不能在问题来看待这个问题或投票被禁止返回。

返回观察家与给定键的问题的列表。

回复
  • 状态200 - 应用程序/ JSON
    返回观察者对问题的列表。
    {
        "self": "http://www.example.com/jira/rest/api/2/issue/EX-1/watchers",
        "isWatching": false,
        "watchCount": 1,
        "watchers": [
            {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "displayName": "Fred F. User",
                "active": false
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/watchers#",
        "title": "Watchers",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "isWatching": {
                "type": "boolean"
            },
            "watchCount": {
                "type": "integer"
            },
            "watchers": {
                "type": "array",
                "items": {
                    "title": "User",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "key": {
                            "type": "string"
                        },
                        "emailAddress": {
                            "type": "string"
                        },
                        "avatarUrls": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "active": {
                            "type": "boolean"
                        },
                        "timeZone": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "active"
                    ]
                }
            }
        },
        "additionalProperties": false,
        "required": [
            "watchCount"
        ]
    }
  • 状态404
    返回如果未找到所请求的问题,或者用户没有权限查看。

将用户添加到一个问题的守望者名单。

请求
"fred"
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/string#",
    "title": "String",
    "type": "string"
}
回复
  • 状态400
    如果没有与接收到的用户表示一个问题返回。
  • 状态401
    如果返回调用用户没有权限到观察者加入到观察的问题的列表。
  • 状态204
    如果返回成功添加的守望者。
  • 状态404
    如果任一问题,或者用户不存在退货。

移除一个问题的守望者列表中的用户。

请求
查询参数
参数 类型 描述
username

包含用户的名称的字符串从监视器列表中删除。 不能为null。

回复
  • 状态400
    返回如果不提供用户名查询参数。
  • 状态401
    如果返回调用用户没有权限从观察者的问题的列表中删除观察者。
  • 状态204
    如果返回观察者被成功取出。
  • 状态404
    如果任一问题不存在,则返回。

返回所有工作日志的问题。注意: 如果日志的工作领域是隐藏的项目工作日志将不予退还。

回复
  • 状态200 - 应用程序/ JSON
    返回与此问题相关,具有计数和分页信息worklogs的集合。
    {
        "startAt": 0,
        "maxResults": 1,
        "total": 1,
        "worklogs": [
            {
                "self": "http://www.example.com/jira/rest/api/2/issue/10010/worklog/10000",
                "author": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "displayName": "Fred F. User",
                    "active": false
                },
                "updateAuthor": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "displayName": "Fred F. User",
                    "active": false
                },
                "comment": "I did some work here.",
                "updated": "2016-09-06T09:48:12.832+0000",
                "visibility": {
                    "type": "group",
                    "value": "jira-developers"
                },
                "started": "2016-09-06T09:48:12.831+0000",
                "timeSpent": "3h 20m",
                "timeSpentSeconds": 12000,
                "id": "100028",
                "issueId": "10002"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/worklog-with-pagination#",
        "title": "Worklog With Pagination",
        "type": "object",
        "properties": {
            "startAt": {
                "type": "integer"
            },
            "maxResults": {
                "type": "integer"
            },
            "total": {
                "type": "integer"
            },
            "worklogs": {
                "type": "array",
                "items": {
                    "title": "Worklog",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "author": {
                            "$ref": "#/definitions/user"
                        },
                        "updateAuthor": {
                            "$ref": "#/definitions/user"
                        },
                        "comment": {
                            "type": "string"
                        },
                        "created": {
                            "type": "string"
                        },
                        "updated": {
                            "type": "string"
                        },
                        "visibility": {
                            "title": "Visibility",
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string",
                                    "enum": [
                                        "group",
                                        "role"
                                    ]
                                },
                                "value": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "started": {
                            "type": "string"
                        },
                        "timeSpent": {
                            "type": "string"
                        },
                        "timeSpentSeconds": {
                            "type": "integer"
                        },
                        "id": {
                            "type": "string"
                        },
                        "issueId": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "definitions": {
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果给定id /关键问题不存在,或者如果当前身份验证的用户没有权限查看它返回。

添加一个新的工作日志条目的问题。

请求
查询参数
参数 类型 描述
adjustEstimate

(可选),您可以提供具体的说明更新问题的剩余时间估计。 有效值为

  • “新” - 将估计为特定值
  • “离开” - 叶子估计因为是
  • “手动” - 指定一个特定的量,以增加估计剩余
  • “自动” - 默认选项。 会自动调整的基础上的工作日志中指定的新timeSpent价值

newEstimate

(当“新”被选择为adjustEstimate必需)对于剩余估计字段中的新值。 例如“二维”

reduceBy

(当需要时“手动”选择为adjustEstimate)由例如“二维”,以减少剩余的估计量

{
    "comment": "I did some work here.",
    "visibility": {
        "type": "group",
        "value": "jira-developers"
    },
    "started": "2016-09-06T09:48:12.830+0000",
    "timeSpentSeconds": 12000
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/worklog#",
    "title": "Worklog",
    "type": "object",
    "properties": {
        "author": {
            "$ref": "#/definitions/user"
        },
        "updateAuthor": {
            "$ref": "#/definitions/user"
        },
        "comment": {
            "type": "string"
        },
        "created": {
            "type": "string"
        },
        "updated": {
            "type": "string"
        },
        "visibility": {
            "title": "Visibility",
            "type": "object",
            "properties": {
                "type": {
                    "type": "string",
                    "enum": [
                        "group",
                        "role"
                    ]
                },
                "value": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "started": {
            "type": "string"
        },
        "timeSpent": {
            "type": "string"
        },
        "timeSpentSeconds": {
            "type": "integer"
        },
        "id": {
            "type": "string"
        },
        "issueId": {
            "type": "string"
        }
    },
    "definitions": {
        "user": {
            "title": "User",
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "key": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态201
    如果返回添加成功
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/worklog#",
        "title": "Worklog",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "author": {
                "$ref": "#/definitions/user"
            },
            "updateAuthor": {
                "$ref": "#/definitions/user"
            },
            "comment": {
                "type": "string"
            },
            "created": {
                "type": "string"
            },
            "updated": {
                "type": "string"
            },
            "visibility": {
                "title": "Visibility",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "group",
                            "role"
                        ]
                    },
                    "value": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "started": {
                "type": "string"
            },
            "timeSpent": {
                "type": "string"
            },
            "timeSpentSeconds": {
                "type": "integer"
            },
            "id": {
                "type": "string"
            },
            "issueId": {
                "type": "string"
            }
        },
        "definitions": {
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果返回输入无效(例如缺少必填字段,无效值,等等)。
  • 状态403
    如果返回调用用户没有权限添加工作日志

返回一个特定的工作日志。注意: 如果日志的工作领域是隐藏该项目的工作日志将不予退还。

回复
  • 状态200 - 应用程序/ JSON
    如果工作日志指定id存在返回,目前已验证的用户有权限查看。 返回的响应包含工作日志JSON格式的完整表示。
    {
        "self": "http://www.example.com/jira/rest/api/2/issue/10010/worklog/10000",
        "author": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "updateAuthor": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "comment": "I did some work here.",
        "updated": "2016-09-06T09:48:12.832+0000",
        "visibility": {
            "type": "group",
            "value": "jira-developers"
        },
        "started": "2016-09-06T09:48:12.831+0000",
        "timeSpent": "3h 20m",
        "timeSpentSeconds": 12000,
        "id": "100028",
        "issueId": "10002"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/worklog#",
        "title": "Worklog",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "author": {
                "$ref": "#/definitions/user"
            },
            "updateAuthor": {
                "$ref": "#/definitions/user"
            },
            "comment": {
                "type": "string"
            },
            "created": {
                "type": "string"
            },
            "updated": {
                "type": "string"
            },
            "visibility": {
                "title": "Visibility",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "group",
                            "role"
                        ]
                    },
                    "value": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "started": {
                "type": "string"
            },
            "timeSpent": {
                "type": "string"
            },
            "timeSpentSeconds": {
                "type": "integer"
            },
            "id": {
                "type": "string"
            },
            "issueId": {
                "type": "string"
            }
        },
        "definitions": {
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果工作日志与给定的ID不存在,或者如果当前身份验证的用户没有权限查看它返回。

更新现有工作日志条目。

注意:

  • 可能的编辑字段有:评论,知名度,开始,timeSpent和timeSpentSeconds。
  • 无论是timeSpent或timeSpentSeconds可以设置。
  • 这是没有设置的字段将不会被更新。
  • 对于一个请求是有效的,它必须具有至少一个字段的改变。

请求
查询参数
参数 类型 描述
adjustEstimate

(可选),您可以提供具体的说明更新问题的剩余时间估计。 有效值为

  • “新” - 将估计为特定值
  • “离开” - 叶子估计因为是
  • “自动” - 默认选项。 会自动调整的基础上的工作日志中指定的新timeSpent价值

newEstimate

(当“新”被选择为adjustEstimate必需)对于剩余估计字段中的新值。

{
    "comment": "I did some work here.",
    "visibility": {
        "type": "group",
        "value": "jira-developers"
    },
    "started": "2016-09-06T09:48:12.830+0000",
    "timeSpentSeconds": 12000
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/worklog#",
    "title": "Worklog",
    "type": "object",
    "properties": {
        "author": {
            "$ref": "#/definitions/user"
        },
        "updateAuthor": {
            "$ref": "#/definitions/user"
        },
        "comment": {
            "type": "string"
        },
        "created": {
            "type": "string"
        },
        "updated": {
            "type": "string"
        },
        "visibility": {
            "title": "Visibility",
            "type": "object",
            "properties": {
                "type": {
                    "type": "string",
                    "enum": [
                        "group",
                        "role"
                    ]
                },
                "value": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "started": {
            "type": "string"
        },
        "timeSpent": {
            "type": "string"
        },
        "timeSpentSeconds": {
            "type": "integer"
        },
        "id": {
            "type": "string"
        },
        "issueId": {
            "type": "string"
        }
    },
    "definitions": {
        "user": {
            "title": "User",
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "key": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    如果返回更新成功
    {
        "self": "http://www.example.com/jira/rest/api/2/issue/10010/worklog/10000",
        "author": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "updateAuthor": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "comment": "I did some work here.",
        "updated": "2016-09-06T09:48:12.832+0000",
        "visibility": {
            "type": "group",
            "value": "jira-developers"
        },
        "started": "2016-09-06T09:48:12.831+0000",
        "timeSpent": "3h 20m",
        "timeSpentSeconds": 12000,
        "id": "100028",
        "issueId": "10002"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/worklog#",
        "title": "Worklog",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "author": {
                "$ref": "#/definitions/user"
            },
            "updateAuthor": {
                "$ref": "#/definitions/user"
            },
            "comment": {
                "type": "string"
            },
            "created": {
                "type": "string"
            },
            "updated": {
                "type": "string"
            },
            "visibility": {
                "title": "Visibility",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "group",
                            "role"
                        ]
                    },
                    "value": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "started": {
                "type": "string"
            },
            "timeSpent": {
                "type": "string"
            },
            "timeSpentSeconds": {
                "type": "integer"
            },
            "id": {
                "type": "string"
            },
            "issueId": {
                "type": "string"
            }
        },
        "definitions": {
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果返回输入无效(例如缺少必填字段,无效值,等等)。
  • 状态403
    返回如果主叫用户没有权限来更新工作日志

删除现有的工作日志条目。

请求
查询参数
参数 类型 描述
adjustEstimate

(可选),您可以提供具体的说明更新问题的剩余时间估计。 有效值为

  • “新” - 将估计为特定值
  • “离开” - 叶子估计因为是
  • “手动” - 指定一个特定的量,以增加估计剩余
  • “自动” - 默认选项。 会自动调整的基础上的工作日志中指定的新timeSpent价值

newEstimate

(当“新”被选择为adjustEstimate必需)对于剩余估计字段中的新值。 例如“二维”

increaseBy

(必要时“手动”选择为adjustEstimate),例如由“2D”,以增加估计剩余量

回复
  • 状态400
    如果返回输入无效(例如缺少必填字段,无效值,等等)。
  • 状态204
    如果返回删除成功
  • 状态403
    如果返回调用用户没有权限删除工作日志

返回创建问题的元数据。 这包括现有的项目,问题类型和领域,包括字段类型以及是否这些字段是必需的。 如果用户没有权限创建在该项目问题的项目将不予退还。

在createmeta字段对应于创建屏幕的项目/问题类型的字段。 不能在屏幕上的字段将不会在createmeta。

字段将仅在返回 expand=projects.issuetypes.fields

结果可以按项目和/或问题类型进行过滤,由查询参数给出。

请求
查询参数
参数 类型 描述
projectIds

与projectKeys参数相结合,列出了其筛选结果的项目。 如果不存在,所有的项目都返回。 此参数可指定多次,和/或以逗号分隔的列表。 Specifiying不存在(或者说你不能在创建问题)的项目是不是一个错误,但它不会在结果中。

projectKeys

与projectIds参数相结合,列出了其筛选结果的项目。 如果为null,所有的项目都返回。 此参数可指定多次,和/或以逗号分隔的列表。 Specifiying不存在(或者说你不能在创建问题)的项目是不是一个错误,但它不会在结果中。

issuetypeIds

与issuetypeNames combinded,列出问题的类型,用以过滤结果。 如果为null,所有的问题类型返回。 此参数可指定多次,和/或以逗号分隔的列表。 Specifiying不存在的一个问题类型不是一个错误。

issuetypeNames

与issuetypeIds combinded,列出问题的类型,用以过滤结果。 如果为null,所有的问题类型返回。 此参数可指定多次,但并不解释为一个逗号分隔的列表。 Specifiying不存在的一个问题类型不是一个错误。

回复
  • 状态200 - 应用程序/ JSON
    返回创建问题的元数据。
    {
        "expand": "projects",
        "projects": [
            {
                "self": "http://www.example.com/jira/rest/api/2/project/EX",
                "id": "10000",
                "key": "EX",
                "name": "Example Project",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/projectavatar?pid=10000&avatarId=10011",
                    "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10000&avatarId=10011",
                    "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10000&avatarId=10011",
                    "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10000&avatarId=10011"
                },
                "issuetypes": [
                    {
                        "self": "http://www.example.com/jira/rest/api/2/issueType/1",
                        "id": "1",
                        "description": "An error in the code",
                        "iconUrl": "http://www.example.com/jira/images/icons/issuetypes/bug.png",
                        "name": "Bug",
                        "subtask": false,
                        "fields": {
                            "issuetype": {
                                "required": true,
                                "name": "Issue Type",
                                "hasDefaultValue": false,
                                "operations": [
                                    "set"
                                ]
                            }
                        }
                    }
                ]
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/create-meta#",
        "title": "Create Meta",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "projects": {
                "type": "array",
                "items": {
                    "title": "Create Meta Project",
                    "type": "object",
                    "properties": {
                        "expand": {
                            "type": "string"
                        },
                        "self": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "key": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "avatarUrls": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "issuetypes": {
                            "type": "array",
                            "items": {
                                "title": "Create Meta Issue Type",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "iconUrl": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "subtask": {
                                        "type": "boolean"
                                    },
                                    "avatarId": {
                                        "type": "integer"
                                    },
                                    "expand": {
                                        "type": "string"
                                    },
                                    "fields": {
                                        "type": "object",
                                        "patternProperties": {
                                            ".+": {
                                                "title": "Field Meta",
                                                "type": "object",
                                                "properties": {
                                                    "required": {
                                                        "type": "boolean"
                                                    },
                                                    "schema": {
                                                        "title": "Json Type",
                                                        "type": "object",
                                                        "properties": {
                                                            "type": {
                                                                "type": "string"
                                                            },
                                                            "items": {
                                                                "type": "string"
                                                            },
                                                            "system": {
                                                                "type": "string"
                                                            },
                                                            "custom": {
                                                                "type": "string"
                                                            },
                                                            "customId": {
                                                                "type": "integer"
                                                            }
                                                        },
                                                        "additionalProperties": false
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "autoCompleteUrl": {
                                                        "type": "string"
                                                    },
                                                    "hasDefaultValue": {
                                                        "type": "boolean"
                                                    },
                                                    "operations": {
                                                        "type": "array",
                                                        "items": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "allowedValues": {
                                                        "type": "array",
                                                        "items": {}
                                                    }
                                                },
                                                "additionalProperties": false,
                                                "required": [
                                                    "required"
                                                ]
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                },
                                "additionalProperties": false,
                                "required": [
                                    "subtask"
                                ]
                            }
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态403
    返回如果用户没有权限查看任何所要求的项目。

返回建议匹配,其执行该请求的用户自动完成查询哪些问题。 这种方法REST将检查用户的历史记录和用户的浏览器上下文并选择此问题,匹配查询哪些。

请求
查询参数
参数 类型 描述
query

查询。

currentJQL

其中执行请求在上下文中JQL。 只有符合这JQL查询哪些问题将被纳入结果。

currentIssueKey

其中执行请求的问题的上下文中的关键。 这是在上下文问题将不被包括在自动完成的结果,即使它的查询相匹配。

currentProjectId

其中执行请求的项目的上下文中的ID。 建议的问题将只能从该项目。

showSubTasks 布尔

如果设置为false,子任务将不包括在列表中。

showSubTaskParent 布尔

如果设置为false,请求以子任务的上下文中执行,父问题不会被列入自动完成的结果,即使它匹配查询。

回复
  • 状态200 - 应用程序/ JSON
    返回的匹配选择器参数,问题列表。
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-picker-result#",
        "title": "Issue Picker Result",
        "type": "object",
        "properties": {
            "sections": {
                "type": "array",
                "items": {
                    "title": "Issue Section",
                    "type": "object",
                    "properties": {
                        "label": {
                            "type": "string"
                        },
                        "sub": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "msg": {
                            "type": "string"
                        },
                        "issues": {
                            "type": "array",
                            "items": {
                                "title": "Issue Picker Issue",
                                "type": "object",
                                "properties": {
                                    "key": {
                                        "type": "string"
                                    },
                                    "keyHtml": {
                                        "type": "string"
                                    },
                                    "img": {
                                        "type": "string"
                                    },
                                    "summary": {
                                        "type": "string"
                                    },
                                    "summaryText": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }

API / 2 /问题/ {} issueIdOrKey /附件隐藏所有方法

问题附件

添加一个或多个附件的问题。

该资源预期一个多职。 媒体类型的multipart / form-data的是在RFC 1867中定义的大多数客户端库都使处理简单的多部分职位类别。 例如,在Java的Apache HTTP组件库提供了 MultiPartEntity ,使得它简单提交多部分POST。

为了防范XSRF攻击,因为这种方法接受的multipart / form-data的,它有它XSRF保护。 这意味着你必须提交的X Atlassian的令牌的头部:该请求没有检查,否则将被阻止。

包含附件必须是“文件”中的multipart / form-data的参数的名称

一个简单的例子来上传了一个名为“myfile.txt的”发行REST-123文件:

卷曲-D- -u管理:管理员-X POST -H“X-Atlassian的令牌:没有勾选”-F“file=@myfile.txt的”http://为myhost / REST / API / 2 /问题/ TEST -123 /附件

回复
  • 状态200 - 应用程序/ JSON
    [
        {
            "self": "http://www.example.com/jira/rest/api/2.0/attachments/10000",
            "filename": "picture.jpg",
            "author": {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                    "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                    "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                    "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                },
                "displayName": "Fred F. User",
                "active": false
            },
            "created": "2016-09-06T09:48:12.753+0000",
            "size": 23123,
            "mimeType": "image/jpeg",
            "content": "http://www.example.com/jira/attachments/10000",
            "thumbnail": "http://www.example.com/jira/secure/thumbnail/10000"
        },
        {
            "self": "http://www.example.com/jira/rest/api/2.0/attachments/10001",
            "filename": "dbeuglog.txt",
            "author": {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                    "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                    "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                    "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                },
                "displayName": "Fred F. User",
                "active": false
            },
            "created": "2016-09-06T09:48:12.753+0000",
            "size": 2460,
            "mimeType": "text/plain",
            "content": "http://www.example.com/jira/attachments/10001",
            "thumbnail": "http://www.example.com/jira/secure/thumbnail/10002"
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-attachment#",
        "title": "List of Attachment",
        "type": "array",
        "items": {
            "title": "Attachment",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "filename": {
                    "type": "string"
                },
                "author": {
                    "title": "User",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "key": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "emailAddress": {
                            "type": "string"
                        },
                        "avatarUrls": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "active": {
                            "type": "boolean"
                        },
                        "timeZone": {
                            "type": "string"
                        },
                        "locale": {
                            "type": "string"
                        },
                        "groups": {
                            "$ref": "#/definitions/simple-list-wrapper"
                        },
                        "applicationRoles": {
                            "$ref": "#/definitions/simple-list-wrapper"
                        },
                        "expand": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "active"
                    ]
                },
                "created": {
                    "type": "string"
                },
                "size": {
                    "type": "integer"
                },
                "mimeType": {
                    "type": "string"
                },
                "properties": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {}
                    },
                    "additionalProperties": false
                },
                "content": {
                    "type": "string"
                },
                "thumbnail": {
                    "type": "string"
                }
            },
            "additionalProperties": false,
            "required": [
                "size"
            ]
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        }
    }
  • 状态403
    如果附件被禁用或退回,如果你没有权限将附件添加到这个问题。
  • 状态404
    返回如果未找到所请求的问题,用户没有权限查看,或者如果附件超出配置的最大附件大小。

API / 2 /问题/ {} issueIdOrKey /属性隐藏所有方法

返回由键或用id标识问题的所有属性的钥匙。

回复
  • 状态200 - 应用程序/ JSON
    如果发现问题返回。
    {
        "keys": [
            {
                "self": "http://www.example.com/jira/rest/api/2/issue/EX-2/properties/issue.support",
                "key": "issue.support"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-properties-keys#",
        "title": "Entity Properties Keys",
        "type": "object",
        "properties": {
            "keys": {
                "type": "array",
                "items": {
                    "title": "Entity Property Key",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "key": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果问题键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    返回如果调用用户没有权限查看该问题。
  • 状态404
    如果返回与给定的密钥或ID的问题不存在,或者如果与给定键的属性没有找到。

移除按键式或由id标识的问题的性质。 THS用户删除属性必须有权限修改的问题。

回复
  • 状态400
    返回如果问题键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态204
    如果返回成功删除问题属性。
  • 状态403
    如果返回调用用户没有权限修改的问题。
  • 状态404
    如果返回与给定的密钥或ID的问题不存在,或者如果与给定键的属性没有找到。

设置指定的问题的属性的值。

你可以使用这个资源来存储反对键或由id标识的问题,自定义数据。 谁存储数据的用户需要具有权限编辑的问题。

回复
  • 状态200
    返回如果问题属性成功更新。
  • 状态201
    如果创建成功,问题属性返回。
  • 状态400
    返回如果问题键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    如果返回调用用户没有权限修改的问题。
  • 状态404
    如果与给定的密钥或ID的问题不存在,则返回。

返回与从由键或由id标识的问题给定键的属性的值。 谁检索属性的用户需要具有的权限来读取的问题。

回复
  • 状态200 - 应用程序/ JSON
    如果问题财产被发现返回。
    {
        "key": "issue.support",
        "value": {
            "hipchat.room.id": "support-123",
            "support.time": "1m"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-property#",
        "title": "Entity Property",
        "type": "object",
        "properties": {
            "key": {
                "type": "string"
            },
            "value": {}
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果问题键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    返回如果调用用户没有权限查看该问题。
  • 状态404
    如果返回与给定的密钥或ID的问题不存在,或者如果与给定键的属性没有找到。

API / 2 /问题/ {} issueIdOrKey /子任务隐藏所有方法

返回问题的子任务列表

回复
  • 状态200
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/response#",
        "title": "Response",
        "type": "object"
    }
  • 状态403
    返回如果用户不能编辑问题
  • 状态404
    如果这个问题不存在,则返回
回复
  • 状态 - 应用程序/ JSON

通过指数“由”动子任务索引“到”重新排序问题的子任务。

请求
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/issue-sub-task-move-position#",
    "title": "Issue Sub Task Move Position",
    "type": "object",
    "properties": {
        "current": {
            "type": "integer"
        },
        "original": {
            "type": "integer"
        }
    },
    "additionalProperties": false,
    "required": [
        "current",
        "original"
    ]
}
回复
  • 状态400
    返回如果从或参数出界
  • 状态204
    返回如果请求成功
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/response#",
        "title": "Response",
        "type": "object"
    }
  • 状态403
    返回如果用户不能编辑问题
  • 状态404
    如果父问题不存在,则返回

领汇发行资源提供的功能来管理问题的链接。

创建两个问题之间的问题的链接。 用户需要将被链接到另一个问题,这个问题的链接问题的权限。 在请求中指定的链接类型用于创建链接并且将创建从第一个问题的第二个问题使用向外描述的链接。 它还创建了第二个问题,第一个问题使用问题链接类型的向内说明的链接。 它将提供的注释添加到第一个问题。 注释可以限制谁可以查看它。 如果指定了组,只有这个组的用户可以查看这条评论,如果roleLevel只指定谁拥有特定角色可以查看此评论的用户。 谁创建问题链路用户需要属于指定组或具有指定的作用。

请求
{
    "type": {
        "name": "Duplicate"
    },
    "inwardIssue": {
        "key": "HSP-1"
    },
    "outwardIssue": {
        "key": "MKY-1"
    },
    "comment": {
        "body": "Linked related issue!",
        "visibility": {
            "type": "group",
            "value": "jira-software-users"
        }
    }
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/link-issue-request#",
    "title": "Link Issue Request",
    "type": "object",
    "properties": {
        "type": {
            "title": "Issue Link Type",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "inward": {
                    "type": "string"
                },
                "outward": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "inwardIssue": {
            "$ref": "#/definitions/issue-ref"
        },
        "outwardIssue": {
            "$ref": "#/definitions/issue-ref"
        },
        "comment": {
            "title": "Comment",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "author": {
                    "$ref": "#/definitions/user"
                },
                "body": {
                    "type": "string"
                },
                "renderedBody": {
                    "type": "string"
                },
                "updateAuthor": {
                    "$ref": "#/definitions/user"
                },
                "created": {
                    "type": "string"
                },
                "updated": {
                    "type": "string"
                },
                "visibility": {
                    "title": "Visibility",
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string",
                            "enum": [
                                "group",
                                "role"
                            ]
                        },
                        "value": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "properties": {
                    "type": "array",
                    "items": {
                        "title": "Entity Property",
                        "type": "object",
                        "properties": {
                            "key": {
                                "type": "string"
                            },
                            "value": {}
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false
        }
    },
    "definitions": {
        "issue-ref": {
            "title": "Issue Ref",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "key": {
                    "type": "string"
                },
                "fields": {
                    "title": "Fields",
                    "type": "object",
                    "properties": {
                        "summary": {
                            "type": "string"
                        },
                        "status": {
                            "title": "Status",
                            "type": "object",
                            "properties": {
                                "statusColor": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "iconUrl": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "id": {
                                    "type": "string"
                                },
                                "statusCategory": {
                                    "title": "Status Category",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "integer"
                                        },
                                        "key": {
                                            "type": "string"
                                        },
                                        "colorName": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "additionalProperties": false
                        },
                        "issuetype": {
                            "title": "Issue Type",
                            "type": "object",
                            "properties": {
                                "id": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "iconUrl": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "subtask": {
                                    "type": "boolean"
                                },
                                "avatarId": {
                                    "type": "integer"
                                }
                            },
                            "additionalProperties": false,
                            "required": [
                                "subtask"
                            ]
                        },
                        "priority": {
                            "title": "Priority",
                            "type": "object",
                            "properties": {
                                "statusColor": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                },
                                "iconUrl": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "id": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        },
        "user": {
            "title": "User",
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "key": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    如果问题链接创建成功。
  • 状态400
    如果它不能创建提供的注释。 响应将包含指示错误消息为什么会失败创建注释。 如果未能创建注释没有问题的链接将被创建。
  • 状态401
    如果用户不具有的问题,这将被链接到另一个问题链路问题的权限。
  • 状态500
    如果创建问题链接或评论时发生错误。
  • 状态404
    如果问题链接被禁用或无法找到的问题之一(问题可能存在,但它是不可见此用户),或无法找到指定的问题链接类型。

返回指定ID的问题链接。

回复
  • 状态200 - 应用程序/ JSON
    {
        "id": "10001",
        "type": {
            "id": "1000",
            "name": "Duplicate",
            "inward": "Duplicated by",
            "outward": "Duplicates",
            "self": "http://www.example.com/jira/rest/api/2//issueLinkType/1000"
        },
        "inwardIssue": {
            "id": "10004",
            "key": "PRJ-3",
            "self": "http://www.example.com/jira/rest/api/2/issue/PRJ-3",
            "fields": {
                "status": {
                    "iconUrl": "http://www.example.com/jira//images/icons/statuses/open.png",
                    "name": "Open"
                }
            }
        },
        "outwardIssue": {
            "id": "10004L",
            "key": "PRJ-2",
            "self": "http://www.example.com/jira/rest/api/2/issue/PRJ-2",
            "fields": {
                "status": {
                    "iconUrl": "http://www.example.com/jira//images/icons/statuses/open.png",
                    "name": "Open"
                }
            }
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-link#",
        "title": "Issue Link",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "type": {
                "title": "Issue Link Type",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "inward": {
                        "type": "string"
                    },
                    "outward": {
                        "type": "string"
                    },
                    "self": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "inwardIssue": {
                "$ref": "#/definitions/issue-ref"
            },
            "outwardIssue": {
                "$ref": "#/definitions/issue-ref"
            }
        },
        "definitions": {
            "issue-ref": {
                "title": "Issue Ref",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "fields": {
                        "title": "Fields",
                        "type": "object",
                        "properties": {
                            "summary": {
                                "type": "string"
                            },
                            "status": {
                                "title": "Status",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string"
                                    },
                                    "statusColor": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "iconUrl": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "statusCategory": {
                                        "title": "Status Category",
                                        "type": "object",
                                        "properties": {
                                            "self": {
                                                "type": "string"
                                            },
                                            "id": {
                                                "type": "integer"
                                            },
                                            "key": {
                                                "type": "string"
                                            },
                                            "colorName": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                },
                                "additionalProperties": false
                            },
                            "issuetype": {
                                "title": "Issue Type",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "iconUrl": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "subtask": {
                                        "type": "boolean"
                                    },
                                    "avatarId": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false,
                                "required": [
                                    "subtask"
                                ]
                            },
                            "priority": {
                                "title": "Priority",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string"
                                    },
                                    "statusColor": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "iconUrl": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "id": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果指定的问题链路ID无效。
  • 状态401
    如果用户不具有的问题,这将被链接到另一个问题链路问题的权限。
  • 状态500
    如果创建问题链接或评论时发生错误。
  • 状态404
    如果问题链接被禁用或无法找到指定的ID的问题链接。 或者是因为没有与此ID存在,或者用户没有看到链接的问题之一的权限。

删除具有指定ID的问题链接。 为了能够删除您必须能够查看这两个问题,一个问题链接,必须有链接问题权限的问题的至少一个。

回复
  • 状态200 - 应用程序/ JSON
  • 状态400
    如果指定的问题链路ID无效。
  • 状态401
    如果用户不具有对于该问题链接的源或目的地问题链路问题的权限。
  • 状态500
    如果删除链接的问题或评论时发生错误。
  • 状态204
    如果成功删除问题链接。
  • 状态404
    如果问题链接被禁用或无法找到指定的ID的问题链接。 或者是因为没有与此ID存在,或者用户没有看到链接的问题之一的权限。

API / 2 / issueLinkType 隐藏所有方法

其余资源检索问题链路类型的列表。

返回可用问题的链接类型的列表,如果启用了问题挂钩。 每个问题链接类型具有一个ID,一个名称和向外和向内链接关系的标签。

回复
  • 状态200 - 应用程序/ JSON
    返回所有可用的问题的链接类型的列表。
    {
        "issueLinkTypes": [
            {
                "id": "1000",
                "name": "Duplicate",
                "inward": "Duplicated by",
                "outward": "Duplicates",
                "self": "http://www.example.com/jira/rest/api/2//issueLinkType/1000"
            },
            {
                "id": "1010",
                "name": "Blocks",
                "inward": "Blocked by",
                "outward": "Blocks",
                "self": "http://www.example.com/jira/rest/api/2//issueLinkType/1010"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-link-types#",
        "title": "Issue Link Types",
        "type": "object",
        "properties": {
            "issueLinkTypes": {
                "type": "array",
                "items": {
                    "title": "Issue Link Type",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "inward": {
                            "type": "string"
                        },
                        "outward": {
                            "type": "string"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果问题链接被禁用返回。

创建一个新的问题链接类型。

请求
{
    "name": "Duplicate",
    "inward": "Duplicated by",
    "outward": "Duplicates"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/issue-link-type#",
    "title": "Issue Link Type",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "inward": {
            "type": "string"
        },
        "outward": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    新的一期链接类型已创建。
    {
        "id": "1000",
        "name": "Duplicate",
        "inward": "Duplicated by",
        "outward": "Duplicates",
        "self": "http://www.example.com/jira/rest/api/2//issueLinkType/1000"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-link-type#",
        "title": "Issue Link Type",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "inward": {
                "type": "string"
            },
            "outward": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            }
        },
        "additionalProperties": false
    }
  • 状态404
    问题挂钩被禁用,或者您没有权限创建问题的链接类型。

对于给定的问题链接类型的id返回有关此问题的链接类型的所有信息。

回复
  • 状态200 - 应用程序/ JSON
    返回给定id的问题链接类型。
    {
        "id": "1000",
        "name": "Duplicate",
        "inward": "Duplicated by",
        "outward": "Duplicates",
        "self": "http://www.example.com/jira/rest/api/2//issueLinkType/1000"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-link-type#",
        "title": "Issue Link Type",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "inward": {
                "type": "string"
            },
            "outward": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果问题链接被禁用或返回给定id没有问题的链接类型存在。

删除指定的问题链接类型。

回复
  • 状态204
  • 状态404
    如果问题链接被禁用或返回给定id没有问题的链接类型存在。

更新指定的问题链接类型。

请求
{
    "name": "Duplicate",
    "inward": "Duplicated by",
    "outward": "Duplicates"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/issue-link-type#",
    "title": "Issue Link Type",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "inward": {
            "type": "string"
        },
        "outward": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    {
        "id": "1000",
        "name": "Duplicate",
        "inward": "Duplicated by",
        "outward": "Duplicates",
        "self": "http://www.example.com/jira/rest/api/2//issueLinkType/1000"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-link-type#",
        "title": "Issue Link Type",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "inward": {
                "type": "string"
            },
            "outward": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果提供的id是不是一个数字。
  • 状态404
    如果问题链接被禁用或返回给定id没有问题的链接类型存在。

API / 2 / issuesecurityschemes 隐藏所有方法

REST资源,允许查看该产品定义的安全方案。

返回定义的所有问题的保障计划。

回复
  • 状态200 - 应用程序/ JSON
    返回用户是否具有管理员权限。
    {
        "issueSecuritySchemes": [
            {
                "self": "http://www.example.com/jira/rest/api/2/issuesecurityschemes/1000",
                "id": 1000,
                "name": "Default Issue Security Scheme",
                "description": "Description for the default issue security scheme",
                "defaultSecurityLevelId": 10021
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/security-schemes#",
        "title": "Security Schemes",
        "type": "object",
        "properties": {
            "issueSecuritySchemes": {
                "type": "array",
                "items": {
                    "title": "Security Scheme",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "id": {
                            "type": "integer"
                        },
                        "name": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "defaultSecurityLevelId": {
                            "type": "integer"
                        },
                        "levels": {
                            "type": "array",
                            "items": {
                                "title": "Security Level",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果用户没有登录。
  • 状态403
    如果用户不具有管理员权限返回。

返回与沿问题的安全方案的定义。

回复
  • 状态200 - 应用程序/ JSON
    如果用户具有管理员权限,或如果方案中,其中用户具有管理权限的一个项目使用的返回。
    {
        "self": "http://www.example.com/jira/rest/api/2/issuesecurityschemes/1000",
        "id": 1000,
        "name": "Default Issue Security Scheme",
        "description": "Description for the default issue security scheme",
        "defaultSecurityLevelId": 10021,
        "levels": [
            {
                "self": "http://www.example.com/jira/rest/api/2/securitylevel/10021",
                "id": "10021",
                "description": "Only the reporter and internal staff can see this issue.",
                "name": "Reporter Only"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/security-scheme#",
        "title": "Security Scheme",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultSecurityLevelId": {
                "type": "integer"
            },
            "levels": {
                "type": "array",
                "items": {
                    "title": "Security Level",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果用户没有登录。
  • 状态403
    返回如果用户不具有管理员权限和方案不是在用户具有管理权限的任何项目使用。

API / 2 /问题类型隐藏所有方法

返回给用户可见的所有问题类型的列表

回复
  • 状态200 - 应用程序/ JSON
    如果问题的类型存在且由主叫用户可见返回。
    [
        {
            "self": "http://localhost:8090/jira/rest/api/2.0/issueType/3",
            "id": "3",
            "description": "A task that needs to be done.",
            "iconUrl": "http://localhost:8090/jira/images/icons/issuetypes/task.png",
            "name": "Task",
            "subtask": false,
            "avatarId": 1
        },
        {
            "self": "http://localhost:8090/jira/rest/api/2.0/issueType/1",
            "id": "1",
            "description": "A problem with the software.",
            "iconUrl": "http://localhost:8090/jira/images/icons/issuetypes/bug.png",
            "name": "Bug",
            "subtask": false,
            "avatarId": 10002
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-issue-type#",
        "title": "List of Issue Type",
        "type": "array",
        "items": {
            "title": "Issue Type",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string"
                },
                "id": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "iconUrl": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "subtask": {
                    "type": "boolean"
                },
                "avatarId": {
                    "type": "integer"
                }
            },
            "additionalProperties": false,
            "required": [
                "subtask"
            ]
        }
    }

从创建JSON表示问题类型,并增加了问题的新创建的问题类型为默认的问题类型方案。

请求
{
    "name": "name",
    "description": "description",
    "type": "standard"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/issue-type-create#",
    "title": "Issue Type Create",
    "type": "object",
    "properties": {
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "type": {
            "type": "string",
            "enum": [
                "subtask",
                "standard"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    如果问题类型创建成功返回。
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-type#",
        "title": "Issue Type",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "id": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "iconUrl": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "subtask": {
                "type": "boolean"
            },
            "avatarId": {
                "type": "integer"
            }
        },
        "additionalProperties": false,
        "required": [
            "subtask"
        ]
    }
  • 状态400
    返回如果请求是无效的。 这种情况发生时的名称是无效或问题类型的实例子任务已禁用的子任务。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    如果返回调用用户没有权限管理JIRA。
  • 状态409
    如果已经存在具有指定名称的问题类型返回。

返回具有给定id的问题类型的完整表示。

回复
  • 状态200 - 应用程序/ JSON
    如果问题的类型存在且由主叫用户可见返回。
    {
        "self": "http://localhost:8090/jira/rest/api/2.0/issueType/3",
        "id": "3",
        "description": "A task that needs to be done.",
        "iconUrl": "http://localhost:8090/jira/images/icons/issuetypes/task.png",
        "name": "Task",
        "subtask": false,
        "avatarId": 1
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-type#",
        "title": "Issue Type",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "id": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "iconUrl": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "subtask": {
                "type": "boolean"
            },
            "avatarId": {
                "type": "integer"
            }
        },
        "additionalProperties": false,
        "required": [
            "subtask"
        ]
    }
  • 状态404
    如果返回的问题类型不存在,或者不是给主叫用户可见。

删除指定的问题类型。 如果问题类型有任何相关问题,这些问题将被迁移到在参数中指定的替代问题类型。 您可以通过调用确定替代问题类型 / REST / API / 2 /问题类型/ {ID} /替代 资源。

请求
查询参数
参数 类型 描述
alternativeIssueTypeId

问题类型的ID到与被删除的问题类型相关的问题将被迁移。

回复
  • 状态400
    返回如果请求是无效的。 它发生在有与正被去除的问题类型相关的问题,但它是不可能的这些问题迁移到替代问题类型。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态204 - 应用程序/ JSON
    如果问题类型成功删除返回。
  • 状态403
    如果返回调用用户没有权限管理JIRA。
  • 状态404
    返回如果这是为了要除去的问题类型不存在或替代问题类型不存在。

从更新JSON表示指定的问题类型。

请求
{
    "name": "name",
    "description": "description",
    "avatarId": 1
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/issue-type-update#",
    "title": "Issue Type Update",
    "type": "object",
    "properties": {
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "avatarId": {
            "type": "integer"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    返回如果问题类型已成功更新。
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-type#",
        "title": "Issue Type",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "id": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "iconUrl": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "subtask": {
                "type": "boolean"
            },
            "avatarId": {
                "type": "integer"
            }
        },
        "additionalProperties": false,
        "required": [
            "subtask"
        ]
    }
  • 状态400
    返回如果请求是无效的。 这种情况发生时的名称是无效的,或者如果给定ID的头像不存在。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    如果返回调用用户没有权限管理JIRA。
  • 状态404
    如果问题类型更新不存在,则返回。
  • 状态409
    如果已经存在具有指定名称的问题类型返回。

返回所有替代问题类型对于给定的问题类型的ID列表。 该列表将包含这些问题的类型,到分配给特定问题类型的问题,可以迁移。 合适的替代品是被分配给相同的工作流,相同的字段结构,并且在同一屏幕方案的问题的类型。

回复
  • 状态200 - 应用程序/ JSON
    如果问题的类型存在且由主叫用户可见返回。
    [
        {
            "self": "http://localhost:8090/jira/rest/api/2.0/issueType/3",
            "id": "3",
            "description": "A task that needs to be done.",
            "iconUrl": "http://localhost:8090/jira/images/icons/issuetypes/task.png",
            "name": "Task",
            "subtask": false,
            "avatarId": 1
        },
        {
            "self": "http://localhost:8090/jira/rest/api/2.0/issueType/1",
            "id": "1",
            "description": "A problem with the software.",
            "iconUrl": "http://localhost:8090/jira/images/icons/issuetypes/bug.png",
            "name": "Bug",
            "subtask": false,
            "avatarId": 10002
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-issue-type#",
        "title": "List of Issue Type",
        "type": "array",
        "items": {
            "title": "Issue Type",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string"
                },
                "id": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "iconUrl": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "subtask": {
                    "type": "boolean"
                },
                "avatarId": {
                    "type": "integer"
                }
            },
            "additionalProperties": false,
            "required": [
                "subtask"
            ]
        }
    }
  • 状态404
    如果返回的问题类型不存在,或者不是给主叫用户可见。

临时化身转换成一个真正的头像

请求
{
    "cropperWidth": 120,
    "cropperOffsetX": 50,
    "cropperOffsetY": 50,
    "needsCropping": false
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
    "title": "Avatar Cropping",
    "type": "object",
    "properties": {
        "cropperWidth": {
            "type": "integer"
        },
        "cropperOffsetX": {
            "type": "integer"
        },
        "cropperOffsetY": {
            "type": "integer"
        },
        "url": {
            "type": "string"
        },
        "needsCropping": {
            "type": "boolean"
        }
    },
    "additionalProperties": false,
    "required": [
        "cropperWidth",
        "cropperOffsetX",
        "cropperOffsetY",
        "needsCropping"
    ]
}
回复
  • 状态201 - 应用程序/ JSON
    返回创建头像
    {
        "id": "1000",
        "owner": "fred",
        "isSystemAvatar": true,
        "isSelected": false,
        "isDeletable": false,
        "urls": {
            "16x16": "http://localhost:8090/jira/secure/useravatar?size=xsmall&avatarId=10040",
            "24x24": "http://localhost:8090/jira/secure/useravatar?size=small&avatarId=10040",
            "32x32": "http://localhost:8090/jira/secure/useravatar?size=medium&avatarId=10040",
            "48x48": "http://localhost:8090/jira/secure/useravatar?avatarId=10040"
        },
        "selected": false
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/avatar#",
        "title": "Avatar",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "owner": {
                "type": "string"
            },
            "isSystemAvatar": {
                "type": "boolean"
            },
            "isSelected": {
                "type": "boolean"
            },
            "isDeletable": {
                "type": "boolean"
            },
            "urls": {
                "type": "object",
                "patternProperties": {
                    "\\d\\dx\\d\\d": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "selected": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "isSystemAvatar",
            "isSelected",
            "isDeletable",
            "selected"
        ]
    }
  • 状态400
    返回如果裁剪坐标无效
  • 状态500
    返回如果在临时化身转换为真正的化身出现错误
  • 状态403
    返回如果当前身份验证的用户没有权限来接头像
  • 状态404
    返回如果当前身份验证的用户不具有编辑项目权限。

创建临时的头像。 创建一个临时的头像是在上传新的头像一个问题类型的3步流程的一部分:上传,裁剪,确认。

下面的实施例示出了使用卷曲这三个步骤。 饼干(会话)需要请求之间要保留,因此,使用-b和-c的。 在步骤2中创建的ID需要传递到步骤3(可以简单地传递步骤2的作为步骤3的请求的整个响应)。

 卷曲-c cookiejar.txt -X POST -u管理:管理员-H“X-Atlassian的令牌:无检查”\
   -H“内容类型:图像/ PNG”--data二进制@ mynewavatar.png \
   的“http://本地主机:8090 / JIRA / REST / API / 2 /问题类型/ 1 /头像/临时文件名= mynewavatar.png”

 卷曲-b cookiejar.txt -X POST -u管理:管理员-H“X-Atlassian的令牌:无检查”\
   -H“内容类型:应用程序/ JSON”--data“{”cropperWidth“:”65“,”cropperOffsetX“:”10“,”cropperOffsetY“:”16“}'\
   -o tmpid.json \
   HTTP://本地主机:8090 / JIRA / REST / API / 2 /问题类型/ 1 /头像

 卷曲-b cookiejar.txt -X PUT -u管理:管理员-H“X-Atlassian的令牌:无检查”\
   -H“内容类型:应用程序/ JSON”--data二进制@ tmpid.json \
   HTTP://本地主机:8090 / JIRA / REST / API / 2 /问题类型/ 1 /头像
 

请求
查询参数
参数 类型 描述
filename

文件的名称被上传

size

文件大小

回复
  • 状态201 - 应用程序/ JSON
    临时头像裁剪说明
    {
        "cropperWidth": 120,
        "cropperOffsetX": 50,
        "cropperOffsetY": 50,
        "url": "http://example.com/jira/secure/temporaryavatar?cropped=true",
        "needsCropping": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
        "title": "Avatar Cropping",
        "type": "object",
        "properties": {
            "cropperWidth": {
                "type": "integer"
            },
            "cropperOffsetX": {
                "type": "integer"
            },
            "cropperOffsetY": {
                "type": "integer"
            },
            "url": {
                "type": "string"
            },
            "needsCropping": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "cropperWidth",
            "cropperOffsetX",
            "cropperOffsetY",
            "needsCropping"
        ]
    }
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    如果返回调用用户没有权限管理JIRA。
  • 状态404
    如果问题类型的更新不存在,或者如果请求不包含有效的XSRF令牌返回。

创建使用多临时头像。 响应被发送回存储在一个textarea JSON。 这是因为客户端使用远程iframing使用多提交化身。 因此,我们必须从回该客户端从解析JSON给他们一个有效的HTML页面。

创建一个临时的头像是在上传新的头像一个问题类型的3步流程的一部分:上传,裁剪,确认。 此端点允许您使用多部分上传的,而不是直接发送图像作为请求体。

你*必须*使用“阿凡达”作为上传参数的名称:

 卷曲-c cookiejar.txt -X POST -u管理:管理员-H“X-Atlassian的令牌:无检查”\
   -F“avatar=@mynewavatar.png;类型=图像/ PNG”\
   的“http://本地主机:8090 / JIRA / REST / API / 2 /问题类型/ 1 /头像/临时”
 

回复
  • 状态201 - text / html的
    临时头像裁剪指令内嵌在HTML页面。 错误信息也将在页面中内嵌。
    {
        "cropperWidth": 120,
        "cropperOffsetX": 50,
        "cropperOffsetY": 50,
        "url": "http://example.com/jira/secure/temporaryavatar?cropped=true",
        "needsCropping": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
        "title": "Avatar Cropping",
        "type": "object",
        "properties": {
            "cropperWidth": {
                "type": "integer"
            },
            "cropperOffsetX": {
                "type": "integer"
            },
            "cropperOffsetY": {
                "type": "integer"
            },
            "url": {
                "type": "string"
            },
            "needsCropping": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "cropperWidth",
            "cropperOffsetX",
            "cropperOffsetY",
            "needsCropping"
        ]
    }
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    如果返回调用用户没有权限管理JIRA。
  • 状态404
    如果问题类型的更新不存在,或者如果请求不包含有效的XSRF令牌返回。

API / 2 /问题类型/ {} issueTypeId /属性隐藏所有方法

这种资源可以存储自定义属性问题类型。

返回由id标识的问题类型的所有属性的钥匙。

回复
  • 状态200 - 应用程序/ JSON
    如果问题类型中发现返回。
    {
        "keys": [
            {
                "self": "http://www.example.com/jira/rest/api/2/issue/EX-2/properties/issue.support",
                "key": "issue.support"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-properties-keys#",
        "title": "Entity Properties Keys",
        "type": "object",
        "properties": {
            "keys": {
                "type": "array",
                "items": {
                    "title": "Entity Property Key",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "key": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果问题类型ID无效。
  • 状态404
    如果问题类型与给定的ID不存在,或者如果用户没有权限查看这个问题类型返回。

移除由id标识的问题类型的属性。 THS用户删除属性必须有权限修改问题类型。

回复
  • 状态400
    返回如果问题类型ID无效。
  • 状态204
    如果返回成功删除的问题类型属性。
  • 状态404
    返回如果问题类型与给定的ID不存在,或者给定键的属性是找不到的。

设置指定的问题类型的属性值。

你可以使用这个资源来存储对由ID标识的问题类型的自定义数据。 谁存储数据的用户需要有权限修改的问题类型。

回复
  • 状态200
    返回如果问题类型属性被成功更新。
  • 状态201
    如果创建成功,问题类型属性返回。
  • 状态400
    返回如果问题类型ID无效。
  • 状态404
    如果问题类型与给定的ID不存在,或者如果用户没有权限编辑此问题类型返回。

返回与由id标识的问题类型的给定键的属性的值。 谁检索的属性的用户需要有权限查看的问题类型。

回复
  • 状态200 - 应用程序/ JSON
    如果问题类型属性被发现返回。
    {
        "key": "issue.support",
        "value": {
            "hipchat.room.id": "support-123",
            "support.time": "1m"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-property#",
        "title": "Entity Property",
        "type": "object",
        "properties": {
            "key": {
                "type": "string"
            },
            "value": {}
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果问题类型ID无效。
  • 状态404
    如果问题类型与给定的ID不存在,或者如果用户没有权限查看这个问题类型返回。

API / 2 / JQL / autocompletedata 隐藏所有方法

资源为搜索自动完成的数据。

返回JQL搜索要求自动完成的数据。

回复
  • 状态200 - 应用程序/ JSON
    需要JQL搜索自动完成的数据。
    "{\"visibleFieldNames\": [{\"value\":\"affectedVersion\",\"displayName\":\"affectedVersion\",\"auto\":\"true\",\"orderable\":\"true\",\"searchable\":\"true\",\"operators\":[\"=\",\"!=\",\"in\",\"not in\",\"is\",\"is not\",\"<\",\"<=\",\">\",\">=\"],\"types\":[\"com.atlassian.jira.project.version.Version\"]},{\"value\":\"assignee\",\"displayName\":\"assignee\",\"auto\":\"true\",\"orderable\":\"true\",\"searchable\":\"true\",\"operators\":[\"!=\",\"was not in\",\"not in\",\"was not\",\"is\",\"was in\",\"was\",\"=\",\"in\",\"changed\",\"is not\"],\"types\":[\"com.atlassian.crowd.embedded.api.User\"]}],\"visibleFunctionNames\": {\"value\":\"currentLogin()\",\"displayName\":\"currentLogin()\",\"types\":[\"java.util.Date\"]},{\"value\":\"currentUser()\",\"displayName\":\"currentUser()\",\"types\":[\"com.atlassian.crowd.embedded.api.User\"]}],\"jqlReservedWords\": \"empty\",\"and\",\"or\",\"in\",\"distinct\"]}"
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/auto-complete-response#",
        "title": "Auto Complete Response",
        "type": "object",
        "properties": {
            "visibleFieldNames": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "visibleFunctionNames": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "jqlReservedWords": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态500
    返回如果在生成响应时发生错误。

返回JQL搜索自动完成建议。

请求
查询参数
参数 类型 描述
fieldName

在生成了建议的字段名称。

fieldValue

这已经由用户提供的字段值的部分。

predicateName

在生成了建议谓词。 “来自”,“通过”和“到”:建议生成只对。

predicateValue

这已经由用户提供的谓词值的部分。

回复
  • 状态200 - 应用程序/ JSON
    为JQL搜索自动完成建议。
    {
        "results": [
            {
                "value": "ActiveObjects",
                "displayName": "<b>Ac</b>tiveObjects (AO)"
            },
            {
                "value": "Atlassian Connect",
                "displayName": "Atlassian Connect (<b>AC</b>)"
            },
            {
                "value": "Atlassian Connect in JIRA",
                "displayName": "Atlassian Connect in JIRA (<b>AC</b>JIRA)"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/auto-complete-result-wrapper#",
        "title": "Auto Complete Result Wrapper",
        "type": "object",
        "properties": {
            "results": {
                "type": "array",
                "items": {
                    "title": "Auto Complete Result",
                    "type": "object",
                    "properties": {
                        "value": {
                            "type": "string"
                        },
                        "displayName": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }

API / 2 / licenseValidator 隐藏所有方法

一个REST端点的JIRA许可证提供简单的验证服务。 通常使用的JIRA应用程序的安装阶段。 这将返回一个对象有错误的键,值对的列表。 显示更多
请求
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/string#",
    "title": "String",
    "type": "string"
}
回复
  • 状态 - 应用程序/ JSON

API / 2 / mypreferences 隐藏所有方法

提供了在当前登录用户的喜好。

当前登录的用户的回报偏好。 选项键必须作为输入参数(密钥)来提供。 该值返回正是因为它是。 如果没有提供或错误关键参数 - 状态码404。如果价值发现 - 状态代码200。

请求
查询参数
参数 类型 描述
key

- 偏好的关键返回。

回复
  • 状态 - 应用程序/ JSON

设置在当前登录用户的偏好。 选项键必须作为输入参数(密钥)来提供。 值必须作为后身体提供。 如果没有提供密钥或值参数 - 状态代码404。如果首选项设置 - 状态代码204。

请求
查询参数
参数 类型 描述
key

- 优先的键来设定。

架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/string#",
    "title": "String",
    "type": "string"
}
回复
  • 状态 - 应用程序/ JSON

删除在当前登录用户的偏好。 选项键必须作为输入参数(密钥)来提供。 如果偏好是未设置状态码404 - - 状态码204如果关键参数不提供或错误。

请求
查询参数
参数 类型 描述
key

- 优先的键被除去。

回复
  • 状态 - 应用程序/ JSON

API / 2 /我隐藏所有方法

当前登录用户资源

返回当前登录的用户。 此资源不能被匿名访问。

回复
  • 状态200 - 应用程序/ JSON
    返回JIRA用户JSON格式的完整表示。
    {
        "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
        "name": "fred",
        "emailAddress": "fred@example.com",
        "avatarUrls": {
            "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
            "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
            "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
            "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
        },
        "displayName": "Fred F. User",
        "active": true,
        "timeZone": "Australia/Sydney",
        "groups": {
            "size": 3,
            "items": [
                {
                    "name": "jira-user",
                    "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-user"
                },
                {
                    "name": "jira-admin",
                    "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-admin"
                },
                {
                    "name": "important",
                    "self": "http://www.example.com/jira/rest/api/2/group?groupname=important"
                }
            ]
        },
        "applicationRoles": {
            "size": 1,
            "items": []
        },
        "expand": "groups,applicationRoles"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/user#",
        "title": "User",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "key": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "emailAddress": {
                "type": "string"
            },
            "avatarUrls": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "displayName": {
                "type": "string"
            },
            "active": {
                "type": "boolean"
            },
            "timeZone": {
                "type": "string"
            },
            "locale": {
                "type": "string"
            },
            "groups": {
                "$ref": "#/definitions/simple-list-wrapper"
            },
            "applicationRoles": {
                "$ref": "#/definitions/simple-list-wrapper"
            },
            "expand": {
                "type": "string"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "active"
        ]
    }
  • 状态401
    返回如果当前用户没有通过验证。

修改当前登录的用户。 目前“价值”字段将覆盖现有的值。 字段跳过请求将不会被改变。 只有电子邮件地址和显示名称可以改变这种方式。 需要用户密码。

请求
{
    "password": "abracadabra",
    "emailAddress": "eddie@atlassian.com",
    "displayName": "Eddie of Atlassian"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/user-write#",
    "title": "User Write",
    "type": "object",
    "properties": {
        "key": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "password": {
            "type": "string"
        },
        "emailAddress": {
            "type": "string"
        },
        "displayName": {
            "type": "string"
        },
        "notification": {
            "type": "string"
        },
        "applicationKeys": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    如果用户存在,并且调用者有权编辑它返回。
    {
        "self": "http://www.example.com/jirahttp://www.example.com/jira/rest/api/2/user/charlie",
        "key": "charlie",
        "name": "eddie",
        "emailAddress": "eddie@atlassian.com",
        "displayName": "Eddie of Atlassian"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/user#",
        "title": "User",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "key": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "emailAddress": {
                "type": "string"
            },
            "avatarUrls": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "displayName": {
                "type": "string"
            },
            "active": {
                "type": "boolean"
            },
            "timeZone": {
                "type": "string"
            },
            "locale": {
                "type": "string"
            },
            "groups": {
                "$ref": "#/definitions/simple-list-wrapper"
            },
            "applicationRoles": {
                "$ref": "#/definitions/simple-list-wrapper"
            },
            "expand": {
                "type": "string"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "active"
        ]
    }
  • 状态400
    如果返回请求无效,包括不正确的密码。
  • 状态401
    返回,如果用户不被认证。
  • 状态403
    如果目录是只读的返回。
  • 状态404
    返回如果用户无法找到。

来电显示修改密码。

请求
{
    "password": "new password",
    "currentPassword": "current password"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/password#",
    "title": "Password",
    "type": "object",
    "properties": {
        "password": {
            "type": "string"
        },
        "currentPassword": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态400
    如果新的密码不正确/丢失或当前密码不正确返回。
  • 状态401
    返回,如果用户不被认证。
  • 状态204
    如果用户存在,并且调用者有权编辑它返回。
  • 状态403
    如果目录是只读的返回。
  • 状态404
    返回如果调用者有权更改用户密码,但用户不存在。

API / 2 / notificationscheme 隐藏所有方法

返回 分页 通知计划表。 为了访问通知方案,需要主叫用户有权限来管理与所请求的通知方案相关联的至少一个项目。 每个方案包含配置为接收通知,这些事件的事件和收件人列表。 消费者应允许在没有收件人的事件出现在响应。 该名单是由该计划的名称排序。 遵循/ notificationscheme / {ID}资源的文档,了解有关返回值的所有细节。

请求
查询参数
参数 类型 描述
startAt

第一个通知计划的指标返回(基于0)。

maxResults INT

通知方案的最大数目,返回(最多50个)。

expand
回复
  • 状态200 - 应用程序/ JSON
    该用户有权限的通知计划的分页列表。
    {
        "maxResults": 6,
        "startAt": 1,
        "total": 5,
        "isLast": false,
        "values": [
            {
                "expand": "notificationSchemeEvents,user,group,projectRole,field,all",
                "id": 10100,
                "self": "http://example.com/jira/rest/api/2/notificationscheme/10010",
                "name": "notification scheme name",
                "description": "description",
                "notificationSchemeEvents": [
                    {
                        "event": {
                            "id": 1,
                            "name": "Issue created",
                            "description": "Event published when issue is created"
                        },
                        "notifications": [
                            {
                                "id": 1,
                                "notificationType": "Group",
                                "parameter": "jira-administrators",
                                "group": {
                                    "name": "jira-administrators",
                                    "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-administrators"
                                },
                                "expand": "group"
                            },
                            {
                                "id": 2,
                                "notificationType": "CurrentAssignee"
                            },
                            {
                                "id": 3,
                                "notificationType": "ProjectRole",
                                "parameter": "10360",
                                "projectRole": {
                                    "self": "http://www.example.com/jira/rest/api/2/project/MKY/role/10360",
                                    "name": "Developers",
                                    "id": 10360,
                                    "description": "A project role that represents developers in a project",
                                    "actors": [
                                        {
                                            "id": 10240,
                                            "displayName": "jira-developers",
                                            "type": "atlassian-group-role-actor",
                                            "name": "jira-developers"
                                        }
                                    ]
                                },
                                "expand": "projectRole"
                            },
                            {
                                "id": 4,
                                "notificationType": "EmailAddress",
                                "parameter": "rest-developer@atlassian.com",
                                "emailAddress": "rest-developer@atlassian.com"
                            },
                            {
                                "id": 5,
                                "notificationType": "User",
                                "user": {
                                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                                    "name": "fred",
                                    "displayName": "Fred F. User",
                                    "active": false
                                },
                                "expand": "user"
                            },
                            {
                                "id": 6,
                                "notificationType": "GroupCustomField",
                                "parameter": "customfield_10101",
                                "field": {
                                    "id": "customfield_10101",
                                    "name": "New custom field",
                                    "custom": true,
                                    "orderable": true,
                                    "navigable": true,
                                    "searchable": true,
                                    "clauseNames": [
                                        "cf[10101]",
                                        "New custom field"
                                    ],
                                    "schema": {
                                        "type": "project",
                                        "custom": "com.atlassian.jira.plugin.system.customfieldtypes:project",
                                        "customId": 10101
                                    }
                                },
                                "expand": "field"
                            }
                        ]
                    },
                    {
                        "event": {
                            "id": 20,
                            "name": "Custom event",
                            "description": "Custom event which is published together with issue created event",
                            "templateEvent": {
                                "id": 1,
                                "name": "Issue created",
                                "description": "Event published when issue is created"
                            }
                        },
                        "notifications": [
                            {
                                "id": 1,
                                "notificationType": "Group",
                                "parameter": "jira-administrators",
                                "group": {
                                    "name": "jira-administrators",
                                    "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-administrators"
                                },
                                "expand": "group"
                            },
                            {
                                "id": 2,
                                "notificationType": "CurrentAssignee"
                            },
                            {
                                "id": 3,
                                "notificationType": "ProjectRole",
                                "parameter": "10360",
                                "projectRole": {
                                    "self": "http://www.example.com/jira/rest/api/2/project/MKY/role/10360",
                                    "name": "Developers",
                                    "id": 10360,
                                    "description": "A project role that represents developers in a project",
                                    "actors": [
                                        {
                                            "id": 10240,
                                            "displayName": "jira-developers",
                                            "type": "atlassian-group-role-actor",
                                            "name": "jira-developers"
                                        }
                                    ]
                                },
                                "expand": "projectRole"
                            },
                            {
                                "id": 4,
                                "notificationType": "EmailAddress",
                                "parameter": "rest-developer@atlassian.com",
                                "emailAddress": "rest-developer@atlassian.com"
                            },
                            {
                                "id": 5,
                                "notificationType": "User",
                                "user": {
                                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                                    "name": "fred",
                                    "displayName": "Fred F. User",
                                    "active": false
                                },
                                "expand": "user"
                            },
                            {
                                "id": 6,
                                "notificationType": "GroupCustomField",
                                "parameter": "customfield_10101",
                                "field": {
                                    "id": "customfield_10101",
                                    "name": "New custom field",
                                    "custom": true,
                                    "orderable": true,
                                    "navigable": true,
                                    "searchable": true,
                                    "clauseNames": [
                                        "cf[10101]",
                                        "New custom field"
                                    ],
                                    "schema": {
                                        "type": "project",
                                        "custom": "com.atlassian.jira.plugin.system.customfieldtypes:project",
                                        "customId": 10101
                                    }
                                },
                                "expand": "field"
                            }
                        ]
                    }
                ]
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/page-of-notification-scheme#",
        "title": "Page of Notification Scheme",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "nextPage": {
                "type": "string",
                "format": "uri"
            },
            "maxResults": {
                "type": "integer"
            },
            "startAt": {
                "type": "integer"
            },
            "total": {
                "type": "integer"
            },
            "isLast": {
                "type": "boolean"
            },
            "values": {
                "type": "array",
                "items": {
                    "title": "Notification Scheme",
                    "type": "object",
                    "properties": {
                        "expand": {
                            "type": "string"
                        },
                        "id": {
                            "type": "integer"
                        },
                        "self": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "notificationSchemeEvents": {
                            "type": "array",
                            "items": {
                                "title": "Notification Scheme Event",
                                "type": "object",
                                "properties": {
                                    "event": {
                                        "$ref": "#/definitions/notification-event"
                                    },
                                    "notifications": {
                                        "type": "array",
                                        "items": {
                                            "title": "Notification",
                                            "type": "object",
                                            "anyOf": [
                                                {
                                                    "$ref": "#/definitions/custom-field-value-notification"
                                                },
                                                {
                                                    "$ref": "#/definitions/email-notification"
                                                },
                                                {
                                                    "$ref": "#/definitions/group-notification"
                                                },
                                                {
                                                    "$ref": "#/definitions/project-role-notification"
                                                },
                                                {
                                                    "$ref": "#/definitions/role-notification"
                                                },
                                                {
                                                    "$ref": "#/definitions/user-notification"
                                                }
                                            ]
                                        }
                                    }
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "definitions": {
            "custom-field-value-notification": {
                "title": "Custom Field Value Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "field": {
                        "title": "Field",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "custom": {
                                "type": "boolean"
                            },
                            "orderable": {
                                "type": "boolean"
                            },
                            "navigable": {
                                "type": "boolean"
                            },
                            "searchable": {
                                "type": "boolean"
                            },
                            "clauseNames": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "schema": {
                                "title": "Json Type",
                                "type": "object",
                                "properties": {
                                    "type": {
                                        "type": "string"
                                    },
                                    "items": {
                                        "type": "string"
                                    },
                                    "system": {
                                        "type": "string"
                                    },
                                    "custom": {
                                        "type": "string"
                                    },
                                    "customId": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "email-notification": {
                "title": "Email Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "group-notification": {
                "title": "Group Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "group": {
                        "title": "Group",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            },
                            "self": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "notification-event": {
                "title": "Notification Event",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "name": {
                        "type": "string"
                    },
                    "description": {
                        "type": "string"
                    },
                    "templateEvent": {
                        "$ref": "#/definitions/notification-event"
                    }
                },
                "additionalProperties": false
            },
            "project-role-notification": {
                "title": "Project Role Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "projectRole": {
                        "title": "Project Role",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string",
                                "format": "uri"
                            },
                            "name": {
                                "type": "string"
                            },
                            "id": {
                                "type": "integer"
                            },
                            "description": {
                                "type": "string"
                            },
                            "actors": {
                                "type": "array",
                                "items": {
                                    "title": "Role Actor",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "integer"
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "avatarUrl": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "role-notification": {
                "title": "Role Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "user-notification": {
                "title": "User Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "user": {
                        "title": "User",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "key": {
                                "type": "string"
                            },
                            "emailAddress": {
                                "type": "string"
                            },
                            "avatarUrls": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "displayName": {
                                "type": "string"
                            },
                            "active": {
                                "type": "boolean"
                            },
                            "timeZone": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "active"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false,
        "required": [
            "maxResults",
            "startAt"
        ]
    }

返回给定ID的通知计划作充分的代表性。 这一资源将返回包含配置为接收通知,这些事件的事件和收件人列表的通知计划。 消费者应允许在没有收件人的事件出现在响应。 用户访问数据需要具有的权限来管理与所请求的通知方案相关联的至少一个项目。

通知收件人可以是:

  • 当前的受让人 - 由NotificationType值为CurrentAssignee
  • 记者的问题 - 由NotificationType的值是记者
  • 当前用户 - 由NotificationType的值的currentUser
  • 项目负责人 - 由NotificationType值为ProjectLead
  • 元件引线 - 由NotificationType值为ComponentLead
  • 所有观察家 - 通知类型的值是AllWatchers
  • 配置的用户-通知类型的值是用户。 参数将包含用户的密钥。 如果将提供有关用户的信息 的用户 使用扩展参数。
  • 配置的组-通知类型的值是组。 参数将包含组的名称。 如果将提供关于集团的资料 用于扩大参数。
  • 配置的电子邮件地址 - 通知类型的值是EmailAddress的,有关电子邮件的附加信息将被提供。
  • 用户或用户在配置的自定义字段组-通知类型的值是UserCustomField或GroupCustomField。 参数将包含自定义字段的ID。 如果将提供有关字段的信息 字段 被用来扩展参数。
  • 配置项目角色-通知类型的值是ProjectRole。 参数将包含项目中的角色ID。 如果将提供有关项目的角色信息 projectRole 参数用于扩展。
请参阅参考的例子。

事件可以是JIRA系统事件或管理员配置的事件。 在该系统中的事件的情况下,提供了有关他们的ID,名称和说明数据。 在自定义事件的情况下,包括在模板事件也是如此。

请求
查询参数
参数 类型 描述
expand
回复
  • 状态200 - 应用程序/ JSON
    如果通知方式存在,并且是可见的主叫用户返回
    {
        "expand": "notificationSchemeEvents,user,group,projectRole,field,all",
        "id": 10100,
        "self": "http://example.com/jira/rest/api/2/notificationscheme/10010",
        "name": "notification scheme name",
        "description": "description",
        "notificationSchemeEvents": [
            {
                "event": {
                    "id": 1,
                    "name": "Issue created",
                    "description": "Event published when issue is created"
                },
                "notifications": [
                    {
                        "id": 1,
                        "notificationType": "Group",
                        "parameter": "jira-administrators",
                        "group": {
                            "name": "jira-administrators",
                            "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-administrators"
                        },
                        "expand": "group"
                    },
                    {
                        "id": 2,
                        "notificationType": "CurrentAssignee"
                    },
                    {
                        "id": 3,
                        "notificationType": "ProjectRole",
                        "parameter": "10360",
                        "projectRole": {
                            "self": "http://www.example.com/jira/rest/api/2/project/MKY/role/10360",
                            "name": "Developers",
                            "id": 10360,
                            "description": "A project role that represents developers in a project",
                            "actors": [
                                {
                                    "id": 10240,
                                    "displayName": "jira-developers",
                                    "type": "atlassian-group-role-actor",
                                    "name": "jira-developers"
                                }
                            ]
                        },
                        "expand": "projectRole"
                    },
                    {
                        "id": 4,
                        "notificationType": "EmailAddress",
                        "parameter": "rest-developer@atlassian.com",
                        "emailAddress": "rest-developer@atlassian.com"
                    },
                    {
                        "id": 5,
                        "notificationType": "User",
                        "user": {
                            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                            "name": "fred",
                            "displayName": "Fred F. User",
                            "active": false
                        },
                        "expand": "user"
                    },
                    {
                        "id": 6,
                        "notificationType": "GroupCustomField",
                        "parameter": "customfield_10101",
                        "field": {
                            "id": "customfield_10101",
                            "name": "New custom field",
                            "custom": true,
                            "orderable": true,
                            "navigable": true,
                            "searchable": true,
                            "clauseNames": [
                                "cf[10101]",
                                "New custom field"
                            ],
                            "schema": {
                                "type": "project",
                                "custom": "com.atlassian.jira.plugin.system.customfieldtypes:project",
                                "customId": 10101
                            }
                        },
                        "expand": "field"
                    }
                ]
            },
            {
                "event": {
                    "id": 20,
                    "name": "Custom event",
                    "description": "Custom event which is published together with issue created event",
                    "templateEvent": {
                        "id": 1,
                        "name": "Issue created",
                        "description": "Event published when issue is created"
                    }
                },
                "notifications": [
                    {
                        "id": 1,
                        "notificationType": "Group",
                        "parameter": "jira-administrators",
                        "group": {
                            "name": "jira-administrators",
                            "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-administrators"
                        },
                        "expand": "group"
                    },
                    {
                        "id": 2,
                        "notificationType": "CurrentAssignee"
                    },
                    {
                        "id": 3,
                        "notificationType": "ProjectRole",
                        "parameter": "10360",
                        "projectRole": {
                            "self": "http://www.example.com/jira/rest/api/2/project/MKY/role/10360",
                            "name": "Developers",
                            "id": 10360,
                            "description": "A project role that represents developers in a project",
                            "actors": [
                                {
                                    "id": 10240,
                                    "displayName": "jira-developers",
                                    "type": "atlassian-group-role-actor",
                                    "name": "jira-developers"
                                }
                            ]
                        },
                        "expand": "projectRole"
                    },
                    {
                        "id": 4,
                        "notificationType": "EmailAddress",
                        "parameter": "rest-developer@atlassian.com",
                        "emailAddress": "rest-developer@atlassian.com"
                    },
                    {
                        "id": 5,
                        "notificationType": "User",
                        "user": {
                            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                            "name": "fred",
                            "displayName": "Fred F. User",
                            "active": false
                        },
                        "expand": "user"
                    },
                    {
                        "id": 6,
                        "notificationType": "GroupCustomField",
                        "parameter": "customfield_10101",
                        "field": {
                            "id": "customfield_10101",
                            "name": "New custom field",
                            "custom": true,
                            "orderable": true,
                            "navigable": true,
                            "searchable": true,
                            "clauseNames": [
                                "cf[10101]",
                                "New custom field"
                            ],
                            "schema": {
                                "type": "project",
                                "custom": "com.atlassian.jira.plugin.system.customfieldtypes:project",
                                "customId": 10101
                            }
                        },
                        "expand": "field"
                    }
                ]
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/notification-scheme#",
        "title": "Notification Scheme",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "self": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "notificationSchemeEvents": {
                "type": "array",
                "items": {
                    "title": "Notification Scheme Event",
                    "type": "object",
                    "properties": {
                        "event": {
                            "$ref": "#/definitions/notification-event"
                        },
                        "notifications": {
                            "type": "array",
                            "items": {
                                "title": "Notification",
                                "type": "object",
                                "anyOf": [
                                    {
                                        "$ref": "#/definitions/custom-field-value-notification"
                                    },
                                    {
                                        "$ref": "#/definitions/email-notification"
                                    },
                                    {
                                        "$ref": "#/definitions/group-notification"
                                    },
                                    {
                                        "$ref": "#/definitions/project-role-notification"
                                    },
                                    {
                                        "$ref": "#/definitions/role-notification"
                                    },
                                    {
                                        "$ref": "#/definitions/user-notification"
                                    }
                                ]
                            }
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "definitions": {
            "custom-field-value-notification": {
                "title": "Custom Field Value Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "field": {
                        "title": "Field",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "custom": {
                                "type": "boolean"
                            },
                            "orderable": {
                                "type": "boolean"
                            },
                            "navigable": {
                                "type": "boolean"
                            },
                            "searchable": {
                                "type": "boolean"
                            },
                            "clauseNames": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "schema": {
                                "title": "Json Type",
                                "type": "object",
                                "properties": {
                                    "type": {
                                        "type": "string"
                                    },
                                    "items": {
                                        "type": "string"
                                    },
                                    "system": {
                                        "type": "string"
                                    },
                                    "custom": {
                                        "type": "string"
                                    },
                                    "customId": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "email-notification": {
                "title": "Email Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "group-notification": {
                "title": "Group Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "group": {
                        "title": "Group",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            },
                            "self": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "notification-event": {
                "title": "Notification Event",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "name": {
                        "type": "string"
                    },
                    "description": {
                        "type": "string"
                    },
                    "templateEvent": {
                        "$ref": "#/definitions/notification-event"
                    }
                },
                "additionalProperties": false
            },
            "project-role-notification": {
                "title": "Project Role Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "projectRole": {
                        "title": "Project Role",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string",
                                "format": "uri"
                            },
                            "name": {
                                "type": "string"
                            },
                            "id": {
                                "type": "integer"
                            },
                            "description": {
                                "type": "string"
                            },
                            "actors": {
                                "type": "array",
                                "items": {
                                    "title": "Role Actor",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "integer"
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "avatarUrl": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "role-notification": {
                "title": "Role Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "user-notification": {
                "title": "User Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "user": {
                        "title": "User",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "key": {
                                "type": "string"
                            },
                            "emailAddress": {
                                "type": "string"
                            },
                            "avatarUrls": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "displayName": {
                                "type": "string"
                            },
                            "active": {
                                "type": "boolean"
                            },
                            "timeZone": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "active"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态404
    返回如果通知方案不存在,或者是不向主叫用户可见

API / 2 /密码隐藏所有方法

相关密码和密码策略操作REST资源。

返回当前密码策略的要求清单。 例如,“密码必须包含至少10个字符”,“密码不能类似于用户的姓名或电子邮件地址。”等等。

请求
查询参数
参数 类型 描述
hasOldPassword 布尔

默认值:

用户是否将被要求输入其当前密码。 使用@code {}假(默认值),如果这是一个新的用户或管理员强制更改其他用户的密码。

回复
  • 状态200 - 应用程序/ JSON
    返回的消息字符串数组。
    架构
    {
        "type": "array",
        "items": {
            "type": "string"
        }
    }

返回声明解释为什么密码政策会为新用户不允许提议口令列表。

您可以使用此方法来测试密码策略验证。 这可能会在那里一个新的用户和相关密码创建一个动作之前完成,使用像那些方法 UserService 例如,你可以使用它来 验证在用户界面中创建用户形式的密码,用户输入它。
用户名和新密码必须不为空进行验证。
请注意,这种方法会帮助你验证对只有政策。 它不会检查可能创建新用户时,例如,检查具有相同的名称的用户是否已经存在执行任何其它的验证。

请求
{
    "username": "fred",
    "displayName": "Fred Normal",
    "emailAddress": "fred@example.com",
    "password": "secret"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/password-policy-create-user#",
    "title": "Password Policy Create User",
    "type": "object",
    "properties": {
        "username": {
            "type": "string"
        },
        "displayName": {
            "type": "string"
        },
        "emailAddress": {
            "type": "string"
        },
        "password": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    返回的消息字符串数组。
    架构
    {
        "type": "array",
        "items": {
            "type": "string"
        }
    }
  • 状态400
    如果返回请求是无效的,比如如果用户名或密码不指定。

返回声明解释为什么密码政策将与现有密码的用户不允许拟议的新密码的列表。

您可以使用此方法来测试密码策略验证。 这可能一个动作,其中的密码实际上是更新之前完成,使用类似方法 的ChangePassword ResetPassword 例如,你可以使用它来 验证在用户界面中更改密码形式的密码,如用户输入它。
用户必须存在,并且用户名和新密码必须不为空,进行验证。
请注意,这方法将帮助您验证只针对政策。 它不会检查可能提交密码更改/复位请求时,例如验证旧密码是否有效执行任何其它的验证。

请求
{
    "username": "fred",
    "oldPassword": "secret",
    "newPassword": "correcthorsebatterystaple"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/password-policy-update-user#",
    "title": "Password Policy Update User",
    "type": "object",
    "properties": {
        "username": {
            "type": "string"
        },
        "oldPassword": {
            "type": "string"
        },
        "newPassword": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    返回的消息字符串数组。
    架构
    {
        "type": "array",
        "items": {
            "type": "string"
        }
    }
  • 状态400
    如果返回请求是无效的,例如,如果用户名或新密码未指定。
  • 状态404
    如果用户名不对应于任何现有的用户返回。

API / 2 / permissionscheme 隐藏所有方法

资源管理权限的计划。

许可方案的权限授予的集合。 每个grant保存有关授予一组用户的权限信息。 这些组的用户被称为 持有者 和由两个值定义为: 类型 参数 类型可以是例如“基团”,或“用户”和 参数 为附加规格。 在群体的情况下,该参数将持有的组名,并在用户的情况下:用户ID。

类型可以通过插件扩展,但这里是所有内置类型(期望的参数内容在括号中给出)的列表:

任何人
授予匿名用户。
(组名)
授予指定组
用户(用户ID)
授予指定用户
projectRole(项目角色ID)
授予指定的项目角色
记者
格兰特为报道的一个问题
projectLead
授予的项目负责人
代理人
授予分配给一个问题一个用户
userCustomField(自定义字段标识)
授予在指定的自定义字段中选择一个用户
groupCustomField(自定义字段标识)
授予在指定的自定义字段中选择一个用户

还有两个“隐藏”的持有人类型,这是不提供点播,但可以在企业的情况下使用:

reporterWithCreatePermission
这种类型只能与BROWSE_PROJECTS许可用于显示,其中用户具有创建内的权限和问题,他们是记者唯一的项目。
assigneeWithAssignablePermission
这种类型只能与BROWSE_PROJECTS许可用于显示在用户具有内的分配的权限和问题,他们是受让人唯一的项目。

除了指定的权限持有者,许可必须被选择。 这样,创建了一对(保持,许可)和它代表单个权限授予。

自定义权限可以通过插件进行添加,但低于我们提出了一套内置的JIRA权限。

  • ADMINISTER_PROJECTS
  • BROWSE_PROJECTS
  • VIEW_DEV_TOOLS
  • VIEW_READONLY_WORKFLOW
  • CREATE_ISSUES
  • EDIT_ISSUES
  • TRANSITION_ISSUES
  • SCHEDULE_ISSUES
  • MOVE_ISSUES
  • ASSIGN_ISSUES
  • ASSIGNABLE_USER
  • RESOLVE_ISSUES
  • CLOSE_ISSUES
  • MODIFY_REPORTER
  • DELETE_ISSUES
  • LINK_ISSUES
  • SET_ISSUE_SECURITY
  • VIEW_VOTERS_AND_WATCHERS
  • MANAGE_WATCHERS
  • ADD_COMMENTS
  • EDIT_ALL_COMMENTS
  • EDIT_OWN_COMMENTS
  • DELETE_ALL_COMMENTS
  • DELETE_OWN_COMMENTS
  • CREATE_ATTACHMENTS
  • DELETE_ALL_ATTACHMENTS
  • DELETE_OWN_ATTACHMENTS
  • WORK_ON_ISSUES
  • EDIT_OWN_WORKLOGS
  • EDIT_ALL_WORKLOGS
  • DELETE_OWN_WORKLOGS
  • DELETE_ALL_WORKLOGS

显示更多

返回所有许可方案的列表。

默认情况下只返回缩短豆。 如果要包括所有计划的权限,然后指定 权限 扩大参数。 权限将如果指定任何其他扩展参数也包括在内。

请求
查询参数
参数 类型 描述
expand
回复
  • 状态200 - 应用程序/ JSON
    如果返回成功。
    {
        "permissionSchemes": [
            {
                "id": 10000,
                "self": "http://www.example.com/jira/rest/api/2/permissionscheme/10000",
                "name": "Example permission scheme",
                "description": "description"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/permission-schemes#",
        "title": "Permission Schemes",
        "type": "object",
        "properties": {
            "permissionSchemes": {
                "type": "array",
                "items": {
                    "title": "Permission Scheme",
                    "type": "object",
                    "properties": {
                        "expand": {
                            "type": "string"
                        },
                        "id": {
                            "type": "integer"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "name": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "permissions": {
                            "type": "array",
                            "items": {
                                "title": "Permission Grant",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "integer"
                                    },
                                    "self": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "holder": {
                                        "title": "Permission Holder",
                                        "type": "object",
                                        "properties": {
                                            "type": {
                                                "type": "string"
                                            },
                                            "parameter": {
                                                "type": "string"
                                            },
                                            "user": {
                                                "title": "User",
                                                "type": "object",
                                                "properties": {
                                                    "self": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "key": {
                                                        "type": "string"
                                                    },
                                                    "emailAddress": {
                                                        "type": "string"
                                                    },
                                                    "avatarUrls": {
                                                        "type": "object",
                                                        "patternProperties": {
                                                            ".+": {
                                                                "type": "string"
                                                            }
                                                        },
                                                        "additionalProperties": false
                                                    },
                                                    "displayName": {
                                                        "type": "string"
                                                    },
                                                    "active": {
                                                        "type": "boolean"
                                                    },
                                                    "timeZone": {
                                                        "type": "string"
                                                    }
                                                },
                                                "additionalProperties": false,
                                                "required": [
                                                    "active"
                                                ]
                                            },
                                            "group": {
                                                "title": "Group",
                                                "type": "object",
                                                "properties": {
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "self": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    }
                                                },
                                                "additionalProperties": false
                                            },
                                            "field": {
                                                "title": "Field",
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "custom": {
                                                        "type": "boolean"
                                                    },
                                                    "orderable": {
                                                        "type": "boolean"
                                                    },
                                                    "navigable": {
                                                        "type": "boolean"
                                                    },
                                                    "searchable": {
                                                        "type": "boolean"
                                                    },
                                                    "clauseNames": {
                                                        "type": "array",
                                                        "items": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "schema": {
                                                        "title": "Json Type",
                                                        "type": "object",
                                                        "properties": {
                                                            "type": {
                                                                "type": "string"
                                                            },
                                                            "items": {
                                                                "type": "string"
                                                            },
                                                            "system": {
                                                                "type": "string"
                                                            },
                                                            "custom": {
                                                                "type": "string"
                                                            },
                                                            "customId": {
                                                                "type": "integer"
                                                            }
                                                        },
                                                        "additionalProperties": false
                                                    }
                                                },
                                                "additionalProperties": false
                                            },
                                            "projectRole": {
                                                "title": "Project Role",
                                                "type": "object",
                                                "properties": {
                                                    "self": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "description": {
                                                        "type": "string"
                                                    },
                                                    "actors": {
                                                        "type": "array",
                                                        "items": {
                                                            "title": "Role Actor",
                                                            "type": "object",
                                                            "properties": {
                                                                "id": {
                                                                    "type": "integer"
                                                                },
                                                                "displayName": {
                                                                    "type": "string"
                                                                },
                                                                "type": {
                                                                    "type": "string"
                                                                },
                                                                "name": {
                                                                    "type": "string"
                                                                },
                                                                "avatarUrl": {
                                                                    "type": "string",
                                                                    "format": "uri"
                                                                }
                                                            },
                                                            "additionalProperties": false
                                                        }
                                                    }
                                                },
                                                "additionalProperties": false
                                            },
                                            "expand": {
                                                "type": "string"
                                            }
                                        },
                                        "additionalProperties": false
                                    },
                                    "permission": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    如果返回的用户没有登录。
  • 状态403
    如果返回的用户无权查看的权限方案。

创建一个新的许可方案。 这种方法可以创建方案具有定义权限集,或没有。

请求
查询参数
参数 类型 描述
expand
{
    "name": "Example permission scheme",
    "description": "description",
    "permissions": [
        {
            "holder": {
                "type": "group",
                "parameter": "jira-developers"
            },
            "permission": "ADMINISTER_PROJECTS"
        }
    ]
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/permission-scheme#",
    "title": "Permission Scheme",
    "type": "object",
    "properties": {
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "permissions": {
            "type": "array",
            "items": {
                "title": "Permission Grant",
                "type": "object",
                "properties": {
                    "holder": {
                        "title": "Permission Holder",
                        "type": "object",
                        "properties": {
                            "type": {
                                "type": "string"
                            },
                            "parameter": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "permission": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            }
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    如果成功创建计划返回。
    {
        "id": 10000,
        "self": "http://www.example.com/jira/rest/api/2/permissionscheme/10000",
        "name": "Example permission scheme",
        "description": "description",
        "permissions": [
            {
                "id": 10000,
                "self": "http://www.example.com/jira/rest/api/2/permissionscheme/permission/10000",
                "holder": {
                    "type": "group",
                    "parameter": "jira-developers",
                    "expand": "group"
                },
                "permission": "ADMINISTER_PROJECTS"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/permission-scheme#",
        "title": "Permission Scheme",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "permissions": {
                "type": "array",
                "items": {
                    "title": "Permission Grant",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "holder": {
                            "title": "Permission Holder",
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string"
                                },
                                "parameter": {
                                    "type": "string"
                                },
                                "user": {
                                    "title": "User",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "key": {
                                            "type": "string"
                                        },
                                        "emailAddress": {
                                            "type": "string"
                                        },
                                        "avatarUrls": {
                                            "type": "object",
                                            "patternProperties": {
                                                ".+": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "active": {
                                            "type": "boolean"
                                        },
                                        "timeZone": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "active"
                                    ]
                                },
                                "group": {
                                    "title": "Group",
                                    "type": "object",
                                    "properties": {
                                        "name": {
                                            "type": "string"
                                        },
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "field": {
                                    "title": "Field",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "custom": {
                                            "type": "boolean"
                                        },
                                        "orderable": {
                                            "type": "boolean"
                                        },
                                        "navigable": {
                                            "type": "boolean"
                                        },
                                        "searchable": {
                                            "type": "boolean"
                                        },
                                        "clauseNames": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        },
                                        "schema": {
                                            "title": "Json Type",
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                },
                                                "items": {
                                                    "type": "string"
                                                },
                                                "system": {
                                                    "type": "string"
                                                },
                                                "custom": {
                                                    "type": "string"
                                                },
                                                "customId": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectRole": {
                                    "title": "Project Role",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "id": {
                                            "type": "integer"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "actors": {
                                            "type": "array",
                                            "items": {
                                                "title": "Role Actor",
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "displayName": {
                                                        "type": "string"
                                                    },
                                                    "type": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "avatarUrl": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "expand": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "permission": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    如果用户没有登录返回。
  • 状态403
    返回如果用户不允许创建许可计划。

返回由指定ID标识的许可方案。

请求
查询参数
参数 类型 描述
expand
回复
  • 状态200 - 应用程序/ JSON
    如果返回成功。
    {
        "id": 10000,
        "self": "http://www.example.com/jira/rest/api/2/permissionscheme/10000",
        "name": "Example permission scheme",
        "description": "description",
        "permissions": [
            {
                "id": 10000,
                "self": "http://www.example.com/jira/rest/api/2/permissionscheme/permission/10000",
                "holder": {
                    "type": "group",
                    "parameter": "jira-developers",
                    "expand": "group"
                },
                "permission": "ADMINISTER_PROJECTS"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/permission-scheme#",
        "title": "Permission Scheme",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "permissions": {
                "type": "array",
                "items": {
                    "title": "Permission Grant",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "holder": {
                            "title": "Permission Holder",
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string"
                                },
                                "parameter": {
                                    "type": "string"
                                },
                                "user": {
                                    "title": "User",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "key": {
                                            "type": "string"
                                        },
                                        "emailAddress": {
                                            "type": "string"
                                        },
                                        "avatarUrls": {
                                            "type": "object",
                                            "patternProperties": {
                                                ".+": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "active": {
                                            "type": "boolean"
                                        },
                                        "timeZone": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "active"
                                    ]
                                },
                                "group": {
                                    "title": "Group",
                                    "type": "object",
                                    "properties": {
                                        "name": {
                                            "type": "string"
                                        },
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "field": {
                                    "title": "Field",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "custom": {
                                            "type": "boolean"
                                        },
                                        "orderable": {
                                            "type": "boolean"
                                        },
                                        "navigable": {
                                            "type": "boolean"
                                        },
                                        "searchable": {
                                            "type": "boolean"
                                        },
                                        "clauseNames": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        },
                                        "schema": {
                                            "title": "Json Type",
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                },
                                                "items": {
                                                    "type": "string"
                                                },
                                                "system": {
                                                    "type": "string"
                                                },
                                                "custom": {
                                                    "type": "string"
                                                },
                                                "customId": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectRole": {
                                    "title": "Project Role",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "id": {
                                            "type": "integer"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "actors": {
                                            "type": "array",
                                            "items": {
                                                "title": "Role Actor",
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "displayName": {
                                                        "type": "string"
                                                    },
                                                    "type": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "avatarUrl": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "expand": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "permission": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    如果返回的用户没有登录。
  • 状态403
    如果返回的用户无权查看的权限方案。
  • 状态404
    如果该方案不存在,则返回。

删除由指定ID标识的许可方案。

回复
  • 状态401
    如果返回的用户没有登录。
  • 状态204 - 应用程序/ JSON
    返回如果权限方案成功删除。
  • 状态403
    如果返回的用户是不允许删除权限方案。

更新许可方案。

如果权限列表存在,那么它会在权限方案,这基本上意味着它会覆盖在权限模式存在的任何权限授予设置。 发送一个空列表将删除权限方案中的所有权限授予。

要更新只是名称和描述,根本不发送权限列表。

要添加或删除单个权限授予而不是更新整个列表一次使用的 {} schemeId /许可/ 资源。

请求
查询参数
参数 类型 描述
expand
{
    "name": "Example permission scheme",
    "description": "description",
    "permissions": [
        {
            "holder": {
                "type": "group",
                "parameter": "jira-developers"
            },
            "permission": "ADMINISTER_PROJECTS"
        }
    ]
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/permission-scheme#",
    "title": "Permission Scheme",
    "type": "object",
    "properties": {
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "permissions": {
            "type": "array",
            "items": {
                "title": "Permission Grant",
                "type": "object",
                "properties": {
                    "holder": {
                        "title": "Permission Holder",
                        "type": "object",
                        "properties": {
                            "type": {
                                "type": "string"
                            },
                            "parameter": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "permission": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            }
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    返回如果方案成功更新。
    {
        "id": 10000,
        "self": "http://www.example.com/jira/rest/api/2/permissionscheme/10000",
        "name": "Example permission scheme",
        "description": "description",
        "permissions": [
            {
                "id": 10000,
                "self": "http://www.example.com/jira/rest/api/2/permissionscheme/permission/10000",
                "holder": {
                    "type": "group",
                    "parameter": "jira-developers",
                    "expand": "group"
                },
                "permission": "ADMINISTER_PROJECTS"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/permission-scheme#",
        "title": "Permission Scheme",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "permissions": {
                "type": "array",
                "items": {
                    "title": "Permission Grant",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "holder": {
                            "title": "Permission Holder",
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string"
                                },
                                "parameter": {
                                    "type": "string"
                                },
                                "user": {
                                    "title": "User",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "key": {
                                            "type": "string"
                                        },
                                        "emailAddress": {
                                            "type": "string"
                                        },
                                        "avatarUrls": {
                                            "type": "object",
                                            "patternProperties": {
                                                ".+": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "active": {
                                            "type": "boolean"
                                        },
                                        "timeZone": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "active"
                                    ]
                                },
                                "group": {
                                    "title": "Group",
                                    "type": "object",
                                    "properties": {
                                        "name": {
                                            "type": "string"
                                        },
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "field": {
                                    "title": "Field",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "custom": {
                                            "type": "boolean"
                                        },
                                        "orderable": {
                                            "type": "boolean"
                                        },
                                        "navigable": {
                                            "type": "boolean"
                                        },
                                        "searchable": {
                                            "type": "boolean"
                                        },
                                        "clauseNames": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        },
                                        "schema": {
                                            "title": "Json Type",
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                },
                                                "items": {
                                                    "type": "string"
                                                },
                                                "system": {
                                                    "type": "string"
                                                },
                                                "custom": {
                                                    "type": "string"
                                                },
                                                "customId": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectRole": {
                                    "title": "Project Role",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "id": {
                                            "type": "integer"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "actors": {
                                            "type": "array",
                                            "items": {
                                                "title": "Role Actor",
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "displayName": {
                                                        "type": "string"
                                                    },
                                                    "type": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "avatarUrl": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "expand": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "permission": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    如果用户没有登录返回。
  • 状态403
    返回如果用户不允许编辑许可计划。
  • 状态404
    如果找不到返回的权限。

返回给定的许可方案的所有权限授予。

请求
查询参数
参数 类型 描述
expand
回复
  • 状态200 - 应用程序/ JSON
    如果返回成功。
    {
        "permissions": [
            {
                "id": 10000,
                "self": "http://www.example.com/jira/rest/api/2/permissionscheme/permission/10000",
                "holder": {
                    "type": "group",
                    "parameter": "jira-developers",
                    "expand": "group"
                },
                "permission": "ADMINISTER_PROJECTS"
            }
        ],
        "expand": "user,group,projectRole,field,all"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/permission-grants#",
        "title": "Permission Grants",
        "type": "object",
        "properties": {
            "permissions": {
                "type": "array",
                "items": {
                    "title": "Permission Grant",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "holder": {
                            "title": "Permission Holder",
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string"
                                },
                                "parameter": {
                                    "type": "string"
                                },
                                "user": {
                                    "title": "User",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "key": {
                                            "type": "string"
                                        },
                                        "emailAddress": {
                                            "type": "string"
                                        },
                                        "avatarUrls": {
                                            "type": "object",
                                            "patternProperties": {
                                                ".+": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "active": {
                                            "type": "boolean"
                                        },
                                        "timeZone": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "active"
                                    ]
                                },
                                "group": {
                                    "title": "Group",
                                    "type": "object",
                                    "properties": {
                                        "name": {
                                            "type": "string"
                                        },
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "field": {
                                    "title": "Field",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "custom": {
                                            "type": "boolean"
                                        },
                                        "orderable": {
                                            "type": "boolean"
                                        },
                                        "navigable": {
                                            "type": "boolean"
                                        },
                                        "searchable": {
                                            "type": "boolean"
                                        },
                                        "clauseNames": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        },
                                        "schema": {
                                            "title": "Json Type",
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                },
                                                "items": {
                                                    "type": "string"
                                                },
                                                "system": {
                                                    "type": "string"
                                                },
                                                "custom": {
                                                    "type": "string"
                                                },
                                                "customId": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectRole": {
                                    "title": "Project Role",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "id": {
                                            "type": "integer"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "actors": {
                                            "type": "array",
                                            "items": {
                                                "title": "Role Actor",
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "displayName": {
                                                        "type": "string"
                                                    },
                                                    "type": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "avatarUrl": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "expand": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "permission": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "expand": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    如果返回的用户没有登录。
  • 状态403
    如果返回的用户无权查看的权限方案。

在创建许可方案的权限授予。

请求
查询参数
参数 类型 描述
expand
{
    "holder": {
        "type": "group",
        "parameter": "jira-developers"
    },
    "permission": "ADMINISTER_PROJECTS"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/permission-grant#",
    "title": "Permission Grant",
    "type": "object",
    "properties": {
        "holder": {
            "title": "Permission Holder",
            "type": "object",
            "properties": {
                "type": {
                    "type": "string"
                },
                "parameter": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "permission": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    如果成功创建该计划允许返回。
    {
        "id": 10000,
        "self": "http://www.example.com/jira/rest/api/2/permissionscheme/permission/10000",
        "holder": {
            "type": "group",
            "parameter": "jira-developers",
            "expand": "group"
        },
        "permission": "ADMINISTER_PROJECTS"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/permission-grant#",
        "title": "Permission Grant",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "holder": {
                "title": "Permission Holder",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "user": {
                        "title": "User",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "key": {
                                "type": "string"
                            },
                            "emailAddress": {
                                "type": "string"
                            },
                            "avatarUrls": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "displayName": {
                                "type": "string"
                            },
                            "active": {
                                "type": "boolean"
                            },
                            "timeZone": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "active"
                        ]
                    },
                    "group": {
                        "title": "Group",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            },
                            "self": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "field": {
                        "title": "Field",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "custom": {
                                "type": "boolean"
                            },
                            "orderable": {
                                "type": "boolean"
                            },
                            "navigable": {
                                "type": "boolean"
                            },
                            "searchable": {
                                "type": "boolean"
                            },
                            "clauseNames": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "schema": {
                                "title": "Json Type",
                                "type": "object",
                                "properties": {
                                    "type": {
                                        "type": "string"
                                    },
                                    "items": {
                                        "type": "string"
                                    },
                                    "system": {
                                        "type": "string"
                                    },
                                    "custom": {
                                        "type": "string"
                                    },
                                    "customId": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "additionalProperties": false
                    },
                    "projectRole": {
                        "title": "Project Role",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string",
                                "format": "uri"
                            },
                            "name": {
                                "type": "string"
                            },
                            "id": {
                                "type": "integer"
                            },
                            "description": {
                                "type": "string"
                            },
                            "actors": {
                                "type": "array",
                                "items": {
                                    "title": "Role Actor",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "integer"
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "avatarUrl": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        },
                        "additionalProperties": false
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "permission": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    如果用户没有登录返回。
  • 状态403
    返回如果用户不允许编辑许可计划。

删除从许可方案的权限授予。

回复
  • 状态401
    如果用户没有登录返回。
  • 状态204 - 应用程序/ JSON
    返回如果权限授予被成功删除。
  • 状态403
    返回如果用户不允许编辑许可计划。

返回由指定ID标识的权限授予。

请求
查询参数
参数 类型 描述
expand
回复
  • 状态200 - 应用程序/ JSON
    如果返回成功。
    {
        "id": 10000,
        "self": "http://www.example.com/jira/rest/api/2/permissionscheme/permission/10000",
        "holder": {
            "type": "group",
            "parameter": "jira-developers",
            "expand": "group"
        },
        "permission": "ADMINISTER_PROJECTS"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/permission-grant#",
        "title": "Permission Grant",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "holder": {
                "title": "Permission Holder",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "user": {
                        "title": "User",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "key": {
                                "type": "string"
                            },
                            "emailAddress": {
                                "type": "string"
                            },
                            "avatarUrls": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "displayName": {
                                "type": "string"
                            },
                            "active": {
                                "type": "boolean"
                            },
                            "timeZone": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "active"
                        ]
                    },
                    "group": {
                        "title": "Group",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            },
                            "self": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "field": {
                        "title": "Field",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "custom": {
                                "type": "boolean"
                            },
                            "orderable": {
                                "type": "boolean"
                            },
                            "navigable": {
                                "type": "boolean"
                            },
                            "searchable": {
                                "type": "boolean"
                            },
                            "clauseNames": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "schema": {
                                "title": "Json Type",
                                "type": "object",
                                "properties": {
                                    "type": {
                                        "type": "string"
                                    },
                                    "items": {
                                        "type": "string"
                                    },
                                    "system": {
                                        "type": "string"
                                    },
                                    "custom": {
                                        "type": "string"
                                    },
                                    "customId": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "additionalProperties": false
                    },
                    "projectRole": {
                        "title": "Project Role",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string",
                                "format": "uri"
                            },
                            "name": {
                                "type": "string"
                            },
                            "id": {
                                "type": "integer"
                            },
                            "description": {
                                "type": "string"
                            },
                            "actors": {
                                "type": "array",
                                "items": {
                                    "title": "Role Actor",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "integer"
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "avatarUrl": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        },
                        "additionalProperties": false
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "permission": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    如果返回的用户没有登录。
  • 状态403
    如果返回的用户无权查看的权限方案。

API / 2 /优先隐藏所有方法

返回所有问题的优先级列表。

回复
  • 状态200 - 应用程序/ JSON
    如果优先级存在,并且用户有权限查看返回。 包含JSON格式的优先充分的代表性。
    [
        {
            "self": "http://www.example.com/jira/rest/api/2/priority/3",
            "statusColor": "#009900",
            "description": "Major loss of function.",
            "iconUrl": "http://www.example.com/jira/images/icons/priorities/major.png",
            "name": "Major"
        },
        {
            "self": "http://www.example.com/jira/rest/api/2/priority/5",
            "statusColor": "#cfcfcf",
            "description": "Very little impact.",
            "iconUrl": "http://www.example.com/jira/images/icons/priorities/trivial.png",
            "name": "Trivial"
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-priority#",
        "title": "List of Priority",
        "type": "array",
        "items": {
            "title": "Priority",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string"
                },
                "statusColor": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "iconUrl": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "id": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    }

返回问题的优先级。

回复
  • 状态200 - 应用程序/ JSON
    如果发行优先存在且由主叫用户可见返回。 包含在JSON问题优先充分的代表性。
    {
        "self": "http://www.example.com/jira/rest/api/2/priority/3",
        "statusColor": "#009900",
        "description": "Major loss of function.",
        "iconUrl": "http://www.example.com/jira/images/icons/priorities/major.png",
        "name": "Major"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/priority#",
        "title": "Priority",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "statusColor": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "iconUrl": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果发行优先级不存在或不是主叫用户可见返回。

API / 2 /项目隐藏所有方法

返回该可见在当前登录用户的所有项目。 如果没有用户登录,它返回的使用匿名访问时可见的项目列表。

请求
查询参数
参数 类型 描述
expand

参数扩大

recent INT

如果该参数设置则仅最近访问的项目由当前用户(如果没有则登录基于HTTP会话)将返回(限指定数量最大计数,但不超过20个)。

回复
  • 状态200 - 应用程序/ JSON
    返回为其用户有浏览,管理或PROJECT_ADMIN项目许可的项目清单。
    [
        {
            "self": "http://www.example.com/jira/rest/api/2/project/EX",
            "id": "10000",
            "key": "EX",
            "name": "Example",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10000",
                "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10000",
                "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10000",
                "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10000"
            },
            "projectCategory": {
                "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
                "id": "10000",
                "name": "FIRST",
                "description": "First Project Category"
            }
        },
        {
            "self": "http://www.example.com/jira/rest/api/2/project/ABC",
            "id": "10001",
            "key": "ABC",
            "name": "Alphabetical",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10001",
                "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10001",
                "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10001",
                "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10001"
            },
            "projectCategory": {
                "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
                "id": "10000",
                "name": "FIRST",
                "description": "First Project Category"
            }
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-project#",
        "title": "List of Project",
        "type": "array",
        "items": {
            "title": "Project",
            "type": "object",
            "properties": {
                "expand": {
                    "type": "string"
                },
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "id": {
                    "type": "string"
                },
                "key": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "lead": {
                    "$ref": "#/definitions/user"
                },
                "components": {
                    "type": "array",
                    "items": {
                        "title": "Component",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string",
                                "format": "uri"
                            },
                            "id": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "lead": {
                                "$ref": "#/definitions/user"
                            },
                            "leadUserName": {
                                "type": "string"
                            },
                            "assigneeType": {
                                "type": "string",
                                "enum": [
                                    "PROJECT_DEFAULT",
                                    "COMPONENT_LEAD",
                                    "PROJECT_LEAD",
                                    "UNASSIGNED"
                                ]
                            },
                            "assignee": {
                                "$ref": "#/definitions/user"
                            },
                            "realAssigneeType": {
                                "type": "string",
                                "enum": [
                                    "PROJECT_DEFAULT",
                                    "COMPONENT_LEAD",
                                    "PROJECT_LEAD",
                                    "UNASSIGNED"
                                ]
                            },
                            "realAssignee": {
                                "$ref": "#/definitions/user"
                            },
                            "isAssigneeTypeValid": {
                                "type": "boolean"
                            },
                            "project": {
                                "type": "string"
                            },
                            "projectId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "isAssigneeTypeValid"
                        ]
                    }
                },
                "issueTypes": {
                    "type": "array",
                    "items": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "url": {
                    "type": "string"
                },
                "email": {
                    "type": "string"
                },
                "assigneeType": {
                    "type": "string",
                    "enum": [
                        "PROJECT_LEAD",
                        "UNASSIGNED"
                    ]
                },
                "versions": {
                    "type": "array",
                    "items": {
                        "title": "Version",
                        "type": "object",
                        "properties": {
                            "expand": {
                                "type": "string"
                            },
                            "self": {
                                "type": "string",
                                "format": "uri"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "archived": {
                                "type": "boolean"
                            },
                            "released": {
                                "type": "boolean"
                            },
                            "overdue": {
                                "type": "boolean"
                            },
                            "userStartDate": {
                                "type": "string"
                            },
                            "userReleaseDate": {
                                "type": "string"
                            },
                            "project": {
                                "type": "string"
                            },
                            "projectId": {
                                "type": "integer"
                            },
                            "moveUnfixedIssuesTo": {
                                "type": "string",
                                "format": "uri"
                            },
                            "operations": {
                                "type": "array",
                                "items": {
                                    "title": "Simple Link",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string"
                                        },
                                        "styleClass": {
                                            "type": "string"
                                        },
                                        "iconClass": {
                                            "type": "string"
                                        },
                                        "label": {
                                            "type": "string"
                                        },
                                        "title": {
                                            "type": "string"
                                        },
                                        "href": {
                                            "type": "string"
                                        },
                                        "weight": {
                                            "type": "integer"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "remotelinks": {
                                "type": "array",
                                "items": {
                                    "title": "Remote Entity Link",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "link": {}
                                    },
                                    "additionalProperties": false
                                }
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "name": {
                    "type": "string"
                },
                "roles": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "projectKeys": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "projectCategory": {
                    "title": "Project Category",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "id": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "projectTypeKey": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        }
    }

创建一个新的项目。

请求
{
    "key": "EX",
    "name": "Example",
    "projectTypeKey": "business",
    "projectTemplateKey": "com.atlassian.jira-core-project-templates:jira-core-project-management",
    "description": "Example Project description",
    "lead": "Charlie",
    "url": "http://atlassian.com",
    "assigneeType": "PROJECT_LEAD",
    "avatarId": 10200,
    "issueSecurityScheme": 10001,
    "permissionScheme": 10011,
    "notificationScheme": 10021,
    "categoryId": 10120
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/project-input#",
    "title": "Project Input",
    "type": "object",
    "properties": {
        "key": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "projectTypeKey": {
            "type": "string"
        },
        "projectTemplateKey": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "lead": {
            "type": "string"
        },
        "url": {
            "type": "string"
        },
        "assigneeType": {
            "type": "string",
            "enum": [
                "PROJECT_LEAD",
                "UNASSIGNED"
            ]
        },
        "avatarId": {
            "type": "integer"
        },
        "issueSecurityScheme": {
            "type": "integer"
        },
        "permissionScheme": {
            "type": "integer"
        },
        "notificationScheme": {
            "type": "integer"
        },
        "categoryId": {
            "type": "integer"
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    返回如果项目创建成功。
    {
        "self": "http://example/jira/rest/api/2/project/10042",
        "id": 10010,
        "key": "EX"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-identity#",
        "title": "Project Identity",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "integer"
            },
            "key": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果该请求是无效的,不能创建的项目返回。
  • 状态401
    返回如果用户没有登录。
  • 状态403
    返回如果用户没有权限创建项目。

包含JSON格式的项目的完整表示。

与该项目相关的所有项目将钥匙只有在返回 expand=projectKeys

请求
查询参数
参数 类型 描述
expand

参数扩大

回复
  • 状态200 - 应用程序/ JSON
    如果项目存在,并且用户有权限查看返回。 包含JSON格式的项目的完整表示。
    {
        "expand": "description,lead,url,projectKeys",
        "self": "http://www.example.com/jira/rest/api/2/project/EX",
        "id": "10000",
        "key": "EX",
        "description": "This project was created as an example for REST.",
        "lead": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "components": [
            {
                "self": "http://www.example.com/jira/rest/api/2/component/10000",
                "id": "10000",
                "name": "Component 1",
                "description": "This is a JIRA component",
                "lead": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "avatarUrls": {
                        "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                        "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                        "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                        "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                    },
                    "displayName": "Fred F. User",
                    "active": false
                },
                "assigneeType": "PROJECT_LEAD",
                "assignee": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "avatarUrls": {
                        "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                        "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                        "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                        "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                    },
                    "displayName": "Fred F. User",
                    "active": false
                },
                "realAssigneeType": "PROJECT_LEAD",
                "realAssignee": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "avatarUrls": {
                        "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                        "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                        "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                        "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                    },
                    "displayName": "Fred F. User",
                    "active": false
                },
                "isAssigneeTypeValid": false,
                "project": "HSP",
                "projectId": 10000
            }
        ],
        "issueTypes": [
            {
                "self": "http://localhost:8090/jira/rest/api/2.0/issueType/3",
                "id": "3",
                "description": "A task that needs to be done.",
                "iconUrl": "http://localhost:8090/jira/images/icons/issuetypes/task.png",
                "name": "Task",
                "subtask": false,
                "avatarId": 1
            },
            {
                "self": "http://localhost:8090/jira/rest/api/2.0/issueType/1",
                "id": "1",
                "description": "A problem with the software.",
                "iconUrl": "http://localhost:8090/jira/images/icons/issuetypes/bug.png",
                "name": "Bug",
                "subtask": false,
                "avatarId": 10002
            }
        ],
        "url": "http://www.example.com/jira/browse/EX",
        "email": "from-jira@example.com",
        "assigneeType": "PROJECT_LEAD",
        "versions": [],
        "name": "Example",
        "roles": {
            "Developers": "http://www.example.com/jira/rest/api/2/project/EX/role/10000"
        },
        "avatarUrls": {
            "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10000",
            "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10000",
            "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10000",
            "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10000"
        },
        "projectCategory": {
            "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
            "id": "10000",
            "name": "FIRST",
            "description": "First Project Category"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project#",
        "title": "Project",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "key": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "lead": {
                "$ref": "#/definitions/user"
            },
            "components": {
                "type": "array",
                "items": {
                    "title": "Component",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "id": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "lead": {
                            "$ref": "#/definitions/user"
                        },
                        "leadUserName": {
                            "type": "string"
                        },
                        "assigneeType": {
                            "type": "string",
                            "enum": [
                                "PROJECT_DEFAULT",
                                "COMPONENT_LEAD",
                                "PROJECT_LEAD",
                                "UNASSIGNED"
                            ]
                        },
                        "assignee": {
                            "$ref": "#/definitions/user"
                        },
                        "realAssigneeType": {
                            "type": "string",
                            "enum": [
                                "PROJECT_DEFAULT",
                                "COMPONENT_LEAD",
                                "PROJECT_LEAD",
                                "UNASSIGNED"
                            ]
                        },
                        "realAssignee": {
                            "$ref": "#/definitions/user"
                        },
                        "isAssigneeTypeValid": {
                            "type": "boolean"
                        },
                        "project": {
                            "type": "string"
                        },
                        "projectId": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "isAssigneeTypeValid"
                    ]
                }
            },
            "issueTypes": {
                "type": "array",
                "items": {
                    "title": "Issue Type",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "iconUrl": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "subtask": {
                            "type": "boolean"
                        },
                        "avatarId": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "subtask"
                    ]
                }
            },
            "url": {
                "type": "string"
            },
            "email": {
                "type": "string"
            },
            "assigneeType": {
                "type": "string",
                "enum": [
                    "PROJECT_LEAD",
                    "UNASSIGNED"
                ]
            },
            "versions": {
                "type": "array",
                "items": {
                    "title": "Version",
                    "type": "object",
                    "properties": {
                        "expand": {
                            "type": "string"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "archived": {
                            "type": "boolean"
                        },
                        "released": {
                            "type": "boolean"
                        },
                        "overdue": {
                            "type": "boolean"
                        },
                        "userStartDate": {
                            "type": "string"
                        },
                        "userReleaseDate": {
                            "type": "string"
                        },
                        "project": {
                            "type": "string"
                        },
                        "projectId": {
                            "type": "integer"
                        },
                        "moveUnfixedIssuesTo": {
                            "type": "string",
                            "format": "uri"
                        },
                        "operations": {
                            "type": "array",
                            "items": {
                                "title": "Simple Link",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "string"
                                    },
                                    "styleClass": {
                                        "type": "string"
                                    },
                                    "iconClass": {
                                        "type": "string"
                                    },
                                    "label": {
                                        "type": "string"
                                    },
                                    "title": {
                                        "type": "string"
                                    },
                                    "href": {
                                        "type": "string"
                                    },
                                    "weight": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "remotelinks": {
                            "type": "array",
                            "items": {
                                "title": "Remote Entity Link",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "link": {}
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                }
            },
            "name": {
                "type": "string"
            },
            "roles": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "avatarUrls": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "projectKeys": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "projectCategory": {
                "title": "Project Category",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "id": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "description": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "projectTypeKey": {
                "type": "string"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态404
    返回如果项目没有找到,或者调用用户没有权限查看。

更新项目。

只有在JSON发送的非空值将在项目进行更新。

可用于assigneeType值是:“PROJECT_LEAD”和“未分配”。

请求
查询参数
参数 类型 描述
expand

这些参数在返回的项目扩大

{
    "key": "EX",
    "name": "Example",
    "projectTypeKey": "business",
    "projectTemplateKey": "com.atlassian.jira-core-project-templates:jira-core-project-management",
    "description": "Example Project description",
    "lead": "Charlie",
    "url": "http://atlassian.com",
    "assigneeType": "PROJECT_LEAD",
    "avatarId": 10200,
    "issueSecurityScheme": 10001,
    "permissionScheme": 10011,
    "notificationScheme": 10021,
    "categoryId": 10120
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/project-input#",
    "title": "Project Input",
    "type": "object",
    "properties": {
        "key": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "projectTypeKey": {
            "type": "string"
        },
        "projectTemplateKey": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "lead": {
            "type": "string"
        },
        "url": {
            "type": "string"
        },
        "assigneeType": {
            "type": "string",
            "enum": [
                "PROJECT_LEAD",
                "UNASSIGNED"
            ]
        },
        "avatarId": {
            "type": "integer"
        },
        "issueSecurityScheme": {
            "type": "integer"
        },
        "permissionScheme": {
            "type": "integer"
        },
        "notificationScheme": {
            "type": "integer"
        },
        "categoryId": {
            "type": "integer"
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    返回如果项目更新成功。
    {
        "expand": "description,lead,url,projectKeys",
        "self": "http://www.example.com/jira/rest/api/2/project/EX",
        "id": "10000",
        "key": "EX",
        "description": "This project was created as an example for REST.",
        "lead": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "components": [
            {
                "self": "http://www.example.com/jira/rest/api/2/component/10000",
                "id": "10000",
                "name": "Component 1",
                "description": "This is a JIRA component",
                "lead": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "avatarUrls": {
                        "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                        "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                        "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                        "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                    },
                    "displayName": "Fred F. User",
                    "active": false
                },
                "assigneeType": "PROJECT_LEAD",
                "assignee": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "avatarUrls": {
                        "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                        "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                        "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                        "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                    },
                    "displayName": "Fred F. User",
                    "active": false
                },
                "realAssigneeType": "PROJECT_LEAD",
                "realAssignee": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "avatarUrls": {
                        "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                        "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                        "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                        "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                    },
                    "displayName": "Fred F. User",
                    "active": false
                },
                "isAssigneeTypeValid": false,
                "project": "HSP",
                "projectId": 10000
            }
        ],
        "issueTypes": [
            {
                "self": "http://localhost:8090/jira/rest/api/2.0/issueType/3",
                "id": "3",
                "description": "A task that needs to be done.",
                "iconUrl": "http://localhost:8090/jira/images/icons/issuetypes/task.png",
                "name": "Task",
                "subtask": false,
                "avatarId": 1
            },
            {
                "self": "http://localhost:8090/jira/rest/api/2.0/issueType/1",
                "id": "1",
                "description": "A problem with the software.",
                "iconUrl": "http://localhost:8090/jira/images/icons/issuetypes/bug.png",
                "name": "Bug",
                "subtask": false,
                "avatarId": 10002
            }
        ],
        "url": "http://www.example.com/jira/browse/EX",
        "email": "from-jira@example.com",
        "assigneeType": "PROJECT_LEAD",
        "versions": [],
        "name": "Example",
        "roles": {
            "Developers": "http://www.example.com/jira/rest/api/2/project/EX/role/10000"
        },
        "avatarUrls": {
            "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10000",
            "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10000",
            "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10000",
            "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10000"
        },
        "projectCategory": {
            "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
            "id": "10000",
            "name": "FIRST",
            "description": "First Project Category"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project#",
        "title": "Project",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "key": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "lead": {
                "$ref": "#/definitions/user"
            },
            "components": {
                "type": "array",
                "items": {
                    "title": "Component",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "id": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "lead": {
                            "$ref": "#/definitions/user"
                        },
                        "leadUserName": {
                            "type": "string"
                        },
                        "assigneeType": {
                            "type": "string",
                            "enum": [
                                "PROJECT_DEFAULT",
                                "COMPONENT_LEAD",
                                "PROJECT_LEAD",
                                "UNASSIGNED"
                            ]
                        },
                        "assignee": {
                            "$ref": "#/definitions/user"
                        },
                        "realAssigneeType": {
                            "type": "string",
                            "enum": [
                                "PROJECT_DEFAULT",
                                "COMPONENT_LEAD",
                                "PROJECT_LEAD",
                                "UNASSIGNED"
                            ]
                        },
                        "realAssignee": {
                            "$ref": "#/definitions/user"
                        },
                        "isAssigneeTypeValid": {
                            "type": "boolean"
                        },
                        "project": {
                            "type": "string"
                        },
                        "projectId": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "isAssigneeTypeValid"
                    ]
                }
            },
            "issueTypes": {
                "type": "array",
                "items": {
                    "title": "Issue Type",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "iconUrl": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "subtask": {
                            "type": "boolean"
                        },
                        "avatarId": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "subtask"
                    ]
                }
            },
            "url": {
                "type": "string"
            },
            "email": {
                "type": "string"
            },
            "assigneeType": {
                "type": "string",
                "enum": [
                    "PROJECT_LEAD",
                    "UNASSIGNED"
                ]
            },
            "versions": {
                "type": "array",
                "items": {
                    "title": "Version",
                    "type": "object",
                    "properties": {
                        "expand": {
                            "type": "string"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "archived": {
                            "type": "boolean"
                        },
                        "released": {
                            "type": "boolean"
                        },
                        "overdue": {
                            "type": "boolean"
                        },
                        "userStartDate": {
                            "type": "string"
                        },
                        "userReleaseDate": {
                            "type": "string"
                        },
                        "project": {
                            "type": "string"
                        },
                        "projectId": {
                            "type": "integer"
                        },
                        "moveUnfixedIssuesTo": {
                            "type": "string",
                            "format": "uri"
                        },
                        "operations": {
                            "type": "array",
                            "items": {
                                "title": "Simple Link",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "string"
                                    },
                                    "styleClass": {
                                        "type": "string"
                                    },
                                    "iconClass": {
                                        "type": "string"
                                    },
                                    "label": {
                                        "type": "string"
                                    },
                                    "title": {
                                        "type": "string"
                                    },
                                    "href": {
                                        "type": "string"
                                    },
                                    "weight": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "remotelinks": {
                            "type": "array",
                            "items": {
                                "title": "Remote Entity Link",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "link": {}
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                }
            },
            "name": {
                "type": "string"
            },
            "roles": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "avatarUrls": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "projectKeys": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "projectCategory": {
                "title": "Project Category",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "id": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "description": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "projectTypeKey": {
                "type": "string"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果请求无效,该项目无法更新。
  • 状态401
    返回如果用户没有登录。
  • 状态403
    返回,如果用户不具有权限更新项目。
  • 状态404
    如果该项目不存在,则返回。

删除的项目。

回复
  • 状态401
    返回如果用户没有登录。
  • 状态204 - 应用程序/ JSON
    返回如果项目成功删除。
  • 状态403
    返回如果当前身份验证的用户没有权限删除该项目。
  • 状态404
    如果该项目不存在,则返回。

临时化身转换成一个真正的头像

请求
{
    "cropperWidth": 120,
    "cropperOffsetX": 50,
    "cropperOffsetY": 50,
    "needsCropping": false
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
    "title": "Avatar Cropping",
    "type": "object",
    "properties": {
        "cropperWidth": {
            "type": "integer"
        },
        "cropperOffsetX": {
            "type": "integer"
        },
        "cropperOffsetY": {
            "type": "integer"
        },
        "url": {
            "type": "string"
        },
        "needsCropping": {
            "type": "boolean"
        }
    },
    "additionalProperties": false,
    "required": [
        "cropperWidth",
        "cropperOffsetX",
        "cropperOffsetY",
        "needsCropping"
    ]
}
回复
  • 状态201 - 应用程序/ JSON
    返回创建头像
    {
        "id": "1000",
        "owner": "fred",
        "isSystemAvatar": true,
        "isSelected": false,
        "isDeletable": false,
        "urls": {
            "16x16": "http://localhost:8090/jira/secure/useravatar?size=xsmall&avatarId=10040",
            "24x24": "http://localhost:8090/jira/secure/useravatar?size=small&avatarId=10040",
            "32x32": "http://localhost:8090/jira/secure/useravatar?size=medium&avatarId=10040",
            "48x48": "http://localhost:8090/jira/secure/useravatar?avatarId=10040"
        },
        "selected": false
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/avatar#",
        "title": "Avatar",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "owner": {
                "type": "string"
            },
            "isSystemAvatar": {
                "type": "boolean"
            },
            "isSelected": {
                "type": "boolean"
            },
            "isDeletable": {
                "type": "boolean"
            },
            "urls": {
                "type": "object",
                "patternProperties": {
                    "\\d\\dx\\d\\d": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "selected": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "isSystemAvatar",
            "isSelected",
            "isDeletable",
            "selected"
        ]
    }
  • 状态400
    返回如果裁剪坐标无效
  • 状态403
    返回如果当前身份验证的用户没有权限来接头像
  • 状态404
    返回如果当前身份验证的用户不具有编辑项目权限。
请求
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/avatar#",
    "title": "Avatar",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "owner": {
            "type": "string"
        },
        "isSystemAvatar": {
            "type": "boolean"
        },
        "isSelected": {
            "type": "boolean"
        },
        "isDeletable": {
            "type": "boolean"
        },
        "urls": {
            "type": "object",
            "patternProperties": {
                "\\d\\dx\\d\\d": {
                    "type": "string",
                    "format": "uri"
                }
            },
            "additionalProperties": false
        },
        "selected": {
            "type": "boolean"
        }
    },
    "additionalProperties": false,
    "required": [
        "isSystemAvatar",
        "isSelected",
        "isDeletable",
        "selected"
    ]
}
回复
  • 状态 - 应用程序/ JSON

删除头像

回复
  • 状态204 - 应用程序/ JSON
    如果返回的头像被成功删除。
  • 状态403
    返回如果当前身份验证的用户没有权限删除的组件。
  • 状态404
    如果分身不存在,或当前身份验证的用户没有权限删除它返回。

创建临时头像

请求
查询参数
参数 类型 描述
filename

文件的名称被上传

size

文件大小

回复
  • 状态201 - 应用程序/ JSON
    临时头像裁剪说明
    {
        "cropperWidth": 120,
        "cropperOffsetX": 50,
        "cropperOffsetY": 50,
        "url": "http://example.com/jira/secure/temporaryavatar?cropped=true",
        "needsCropping": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
        "title": "Avatar Cropping",
        "type": "object",
        "properties": {
            "cropperWidth": {
                "type": "integer"
            },
            "cropperOffsetX": {
                "type": "integer"
            },
            "cropperOffsetY": {
                "type": "integer"
            },
            "url": {
                "type": "string"
            },
            "needsCropping": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "cropperWidth",
            "cropperOffsetX",
            "cropperOffsetY",
            "needsCropping"
        ]
    }
  • 状态400
    验证失败。 例如文件大小超出最大附件大小。
  • 状态403
    如果请求不包含有效XSRF令牌返回
  • 状态404
    返回如果当前身份验证的用户不具有编辑项目权限。

创建使用多临时头像。 响应被发送回存储在一个textarea JSON。 这是因为客户端使用远程iframing使用多提交化身。 因此,我们必须给他们一个有效的HTML页面返回从客户端解析JSON。

回复
  • 状态201 - text / html的
    临时头像裁剪指令内嵌在HTML页面。 错误信息也将在页面中内嵌。
    {
        "cropperWidth": 120,
        "cropperOffsetX": 50,
        "cropperOffsetY": 50,
        "url": "http://example.com/jira/secure/temporaryavatar?cropped=true",
        "needsCropping": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
        "title": "Avatar Cropping",
        "type": "object",
        "properties": {
            "cropperWidth": {
                "type": "integer"
            },
            "cropperOffsetX": {
                "type": "integer"
            },
            "cropperOffsetY": {
                "type": "integer"
            },
            "url": {
                "type": "string"
            },
            "needsCropping": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "cropperWidth",
            "cropperOffsetX",
            "cropperOffsetY",
            "needsCropping"
        ]
    }
  • 状态404
    返回如果当前身份验证的用户不具有编辑项目权限。

返回该可见在当前登录用户的所有化身。 化身分为系统和自定义。

回复
  • 状态200 - 应用程序/ JSON
    返回包含替身的列表为定制的系统替身,其中用户具有浏览项目的权限的地图。
    {
        "system": [
            {
                "id": "1000",
                "owner": "fred",
                "isSystemAvatar": true,
                "isSelected": false,
                "isDeletable": false,
                "urls": {
                    "16x16": "http://localhost:8090/jira/secure/useravatar?size=xsmall&avatarId=10040",
                    "24x24": "http://localhost:8090/jira/secure/useravatar?size=small&avatarId=10040",
                    "32x32": "http://localhost:8090/jira/secure/useravatar?size=medium&avatarId=10040",
                    "48x48": "http://localhost:8090/jira/secure/useravatar?avatarId=10040"
                },
                "selected": false
            }
        ],
        "custom": [
            {
                "id": "1010",
                "owner": "andrew",
                "isSystemAvatar": false,
                "isSelected": false,
                "isDeletable": true,
                "urls": {
                    "16x16": "http://localhost:8090/jira/secure/useravatar?size=xsmall&avatarId=10080",
                    "24x24": "http://localhost:8090/jira/secure/useravatar?size=small&avatarId=10080",
                    "32x32": "http://localhost:8090/jira/secure/useravatar?size=medium&avatarId=10080",
                    "48x48": "http://localhost:8090/jira/secure/useravatar?avatarId=10080"
                },
                "selected": false
            }
        ]
    }
    架构
    {
        "type": "object",
        "patternProperties": {
            ".+": {
                "type": "array",
                "items": {
                    "title": "Avatar",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "owner": {
                            "type": "string"
                        },
                        "isSystemAvatar": {
                            "type": "boolean"
                        },
                        "isSelected": {
                            "type": "boolean"
                        },
                        "isDeletable": {
                            "type": "boolean"
                        },
                        "urls": {
                            "type": "object",
                            "patternProperties": {
                                "\\d\\dx\\d\\d": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        },
                        "selected": {
                            "type": "boolean"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "isSystemAvatar",
                        "isSelected",
                        "isDeletable",
                        "selected"
                    ]
                }
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果返回目前已验证的用户没有查看项目的权限。

包含一个指定的项目的组件的完整表示。

回复
  • 状态200 - 应用程序/ JSON
    如果项目存在,并且用户有权查看其组件返回。 包含JSON格式的项目的组件的完整表示。
    [
        {
            "self": "http://www.example.com/jira/rest/api/2/component/10000",
            "id": "10000",
            "name": "Component 1",
            "description": "This is a JIRA component",
            "lead": {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                    "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                    "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                    "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                },
                "displayName": "Fred F. User",
                "active": false
            },
            "assigneeType": "PROJECT_LEAD",
            "assignee": {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                    "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                    "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                    "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                },
                "displayName": "Fred F. User",
                "active": false
            },
            "realAssigneeType": "PROJECT_LEAD",
            "realAssignee": {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                    "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                    "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                    "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                },
                "displayName": "Fred F. User",
                "active": false
            },
            "isAssigneeTypeValid": false,
            "project": "HSP",
            "projectId": 10000
        },
        {
            "self": "http://www.example.com/jira/rest/api/2/component/10000",
            "id": "10050",
            "name": "PXA",
            "description": "This is a another JIRA component",
            "lead": {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                    "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                    "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                    "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                },
                "displayName": "Fred F. User",
                "active": false
            },
            "assigneeType": "PROJECT_LEAD",
            "assignee": {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                    "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                    "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                    "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                },
                "displayName": "Fred F. User",
                "active": false
            },
            "realAssigneeType": "PROJECT_LEAD",
            "realAssignee": {
                "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                "name": "fred",
                "avatarUrls": {
                    "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                    "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                    "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                    "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                },
                "displayName": "Fred F. User",
                "active": false
            },
            "isAssigneeTypeValid": false,
            "project": "PROJECTKEY",
            "projectId": 10000
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-component#",
        "title": "List of Component",
        "type": "array",
        "items": {
            "title": "Component",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "id": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "lead": {
                    "$ref": "#/definitions/user"
                },
                "leadUserName": {
                    "type": "string"
                },
                "assigneeType": {
                    "type": "string",
                    "enum": [
                        "PROJECT_DEFAULT",
                        "COMPONENT_LEAD",
                        "PROJECT_LEAD",
                        "UNASSIGNED"
                    ]
                },
                "assignee": {
                    "$ref": "#/definitions/user"
                },
                "realAssigneeType": {
                    "type": "string",
                    "enum": [
                        "PROJECT_DEFAULT",
                        "COMPONENT_LEAD",
                        "PROJECT_LEAD",
                        "UNASSIGNED"
                    ]
                },
                "realAssignee": {
                    "$ref": "#/definitions/user"
                },
                "isAssigneeTypeValid": {
                    "type": "boolean"
                },
                "project": {
                    "type": "string"
                },
                "projectId": {
                    "type": "integer"
                }
            },
            "additionalProperties": false,
            "required": [
                "isAssigneeTypeValid"
            ]
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        }
    }
  • 状态404
    返回如果项目没有找到,或者调用用户没有权限查看。

获取所有的问题类型的有效状态值项目

回复
  • 状态200 - 应用程序/ JSON
    如果项目存在,并且用户有权查看其组件返回。 包含的问题类型与有效期为每个问题类型的状态值完整表示。
    [
        {
            "self": "http://localhost:8090/jira/rest/api/2.0/issueType/3",
            "id": "3",
            "name": "Task",
            "subtask": false,
            "statuses": [
                {
                    "self": "http://localhost:8090/jira/rest/api/2.0/status/10000",
                    "description": "The issue is currently being worked on.",
                    "iconUrl": "http://localhost:8090/jira/images/icons/progress.gif",
                    "name": "In Progress",
                    "id": "10000"
                },
                {
                    "self": "http://localhost:8090/jira/rest/api/2.0/status/5",
                    "description": "The issue is closed.",
                    "iconUrl": "http://localhost:8090/jira/images/icons/closed.gif",
                    "name": "Closed",
                    "id": "5"
                }
            ]
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-issue-type-with-status#",
        "title": "List of Issue Type With Status",
        "type": "array",
        "items": {
            "title": "Issue Type With Status",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string"
                },
                "id": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "subtask": {
                    "type": "boolean"
                },
                "statuses": {
                    "type": "array",
                    "items": {
                        "title": "Status",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "statusColor": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "statusCategory": {
                                "title": "Status Category",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string"
                                    },
                                    "id": {
                                        "type": "integer"
                                    },
                                    "key": {
                                        "type": "string"
                                    },
                                    "colorName": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "subtask"
            ]
        }
    }
  • 状态400
    返回如果项目没有找到,或者调用用户没有权限查看。

更新的一个项目的类型。

回复
  • 状态200 - 应用程序/ JSON
    返回如果更新的项目类型是成功的。
    {
        "expand": "description,lead,url,projectKeys",
        "self": "http://www.example.com/jira/rest/api/2/project/EX",
        "id": "10000",
        "key": "EX",
        "description": "This project was created as an example for REST.",
        "lead": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        "components": [
            {
                "self": "http://www.example.com/jira/rest/api/2/component/10000",
                "id": "10000",
                "name": "Component 1",
                "description": "This is a JIRA component",
                "lead": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "avatarUrls": {
                        "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                        "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                        "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                        "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                    },
                    "displayName": "Fred F. User",
                    "active": false
                },
                "assigneeType": "PROJECT_LEAD",
                "assignee": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "avatarUrls": {
                        "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                        "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                        "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                        "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                    },
                    "displayName": "Fred F. User",
                    "active": false
                },
                "realAssigneeType": "PROJECT_LEAD",
                "realAssignee": {
                    "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                    "name": "fred",
                    "avatarUrls": {
                        "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                        "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                        "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                        "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
                    },
                    "displayName": "Fred F. User",
                    "active": false
                },
                "isAssigneeTypeValid": false,
                "project": "HSP",
                "projectId": 10000
            }
        ],
        "issueTypes": [
            {
                "self": "http://localhost:8090/jira/rest/api/2.0/issueType/3",
                "id": "3",
                "description": "A task that needs to be done.",
                "iconUrl": "http://localhost:8090/jira/images/icons/issuetypes/task.png",
                "name": "Task",
                "subtask": false,
                "avatarId": 1
            },
            {
                "self": "http://localhost:8090/jira/rest/api/2.0/issueType/1",
                "id": "1",
                "description": "A problem with the software.",
                "iconUrl": "http://localhost:8090/jira/images/icons/issuetypes/bug.png",
                "name": "Bug",
                "subtask": false,
                "avatarId": 10002
            }
        ],
        "url": "http://www.example.com/jira/browse/EX",
        "email": "from-jira@example.com",
        "assigneeType": "PROJECT_LEAD",
        "versions": [],
        "name": "Example",
        "roles": {
            "Developers": "http://www.example.com/jira/rest/api/2/project/EX/role/10000"
        },
        "avatarUrls": {
            "48x48": "http://www.example.com/jira/secure/projectavatar?size=large&pid=10000",
            "24x24": "http://www.example.com/jira/secure/projectavatar?size=small&pid=10000",
            "16x16": "http://www.example.com/jira/secure/projectavatar?size=xsmall&pid=10000",
            "32x32": "http://www.example.com/jira/secure/projectavatar?size=medium&pid=10000"
        },
        "projectCategory": {
            "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
            "id": "10000",
            "name": "FIRST",
            "description": "First Project Category"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project#",
        "title": "Project",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "key": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "lead": {
                "$ref": "#/definitions/user"
            },
            "components": {
                "type": "array",
                "items": {
                    "title": "Component",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "id": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "lead": {
                            "$ref": "#/definitions/user"
                        },
                        "leadUserName": {
                            "type": "string"
                        },
                        "assigneeType": {
                            "type": "string",
                            "enum": [
                                "PROJECT_DEFAULT",
                                "COMPONENT_LEAD",
                                "PROJECT_LEAD",
                                "UNASSIGNED"
                            ]
                        },
                        "assignee": {
                            "$ref": "#/definitions/user"
                        },
                        "realAssigneeType": {
                            "type": "string",
                            "enum": [
                                "PROJECT_DEFAULT",
                                "COMPONENT_LEAD",
                                "PROJECT_LEAD",
                                "UNASSIGNED"
                            ]
                        },
                        "realAssignee": {
                            "$ref": "#/definitions/user"
                        },
                        "isAssigneeTypeValid": {
                            "type": "boolean"
                        },
                        "project": {
                            "type": "string"
                        },
                        "projectId": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "isAssigneeTypeValid"
                    ]
                }
            },
            "issueTypes": {
                "type": "array",
                "items": {
                    "title": "Issue Type",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "iconUrl": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "subtask": {
                            "type": "boolean"
                        },
                        "avatarId": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "subtask"
                    ]
                }
            },
            "url": {
                "type": "string"
            },
            "email": {
                "type": "string"
            },
            "assigneeType": {
                "type": "string",
                "enum": [
                    "PROJECT_LEAD",
                    "UNASSIGNED"
                ]
            },
            "versions": {
                "type": "array",
                "items": {
                    "title": "Version",
                    "type": "object",
                    "properties": {
                        "expand": {
                            "type": "string"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "archived": {
                            "type": "boolean"
                        },
                        "released": {
                            "type": "boolean"
                        },
                        "overdue": {
                            "type": "boolean"
                        },
                        "userStartDate": {
                            "type": "string"
                        },
                        "userReleaseDate": {
                            "type": "string"
                        },
                        "project": {
                            "type": "string"
                        },
                        "projectId": {
                            "type": "integer"
                        },
                        "moveUnfixedIssuesTo": {
                            "type": "string",
                            "format": "uri"
                        },
                        "operations": {
                            "type": "array",
                            "items": {
                                "title": "Simple Link",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "string"
                                    },
                                    "styleClass": {
                                        "type": "string"
                                    },
                                    "iconClass": {
                                        "type": "string"
                                    },
                                    "label": {
                                        "type": "string"
                                    },
                                    "title": {
                                        "type": "string"
                                    },
                                    "href": {
                                        "type": "string"
                                    },
                                    "weight": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "remotelinks": {
                            "type": "array",
                            "items": {
                                "title": "Remote Entity Link",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "link": {}
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                }
            },
            "name": {
                "type": "string"
            },
            "roles": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "avatarUrls": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "projectKeys": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "projectCategory": {
                "title": "Project Category",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "id": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "description": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "projectTypeKey": {
                "type": "string"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            },
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果请求无效,项目类型无法更新返回。
  • 状态401
    返回如果用户没有登录。
  • 状态403
    返回,如果用户不具有权限更新项目。
  • 状态404
    如果该项目不存在,则返回。

返回所有版本的指定项目。 结果 分页

结果可以通过以下字段可以订购:

  • 序列
  • 名称
  • 开始日期
  • 发布日期

请求
查询参数
参数 类型 描述
startAt

页面偏移,如果不指定,则默认为0

maxResults INT

在页面上的许多结果应被包括在内。 默认为50。

orderBy

结果的排序。

expand

参数扩大

回复
  • 状态200 - 应用程序/ JSON
    第一个版本的项目。
    {
        "self": "http://www.example.com/jira/rest/api/2/project/PR/version?startAt=0&maxResults=2",
        "nextPage": "http://www.example.com/jira/rest/api/2/project/PR/version?startAt=2&maxResults=2",
        "maxResults": 2,
        "startAt": 0,
        "total": 7,
        "isLast": false,
        "values": [
            {
                "self": "http://www.example.com/jira/rest/api/2/version/10000",
                "id": "10000",
                "description": "An excellent version",
                "name": "New Version 1",
                "archived": false,
                "released": true,
                "releaseDate": "2010-07-06",
                "overdue": true,
                "userReleaseDate": "6/Jul/2010",
                "projectId": 10000
            },
            {
                "self": "http://www.example.com/jira/rest/api/2/version/10010",
                "id": "10010",
                "description": "Minor Bugfix version",
                "name": "Next Version",
                "archived": false,
                "released": false,
                "overdue": false,
                "projectId": 10000
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/page-of-version#",
        "title": "Page of Version",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "nextPage": {
                "type": "string",
                "format": "uri"
            },
            "maxResults": {
                "type": "integer"
            },
            "startAt": {
                "type": "integer"
            },
            "total": {
                "type": "integer"
            },
            "isLast": {
                "type": "boolean"
            },
            "values": {
                "type": "array",
                "items": {
                    "title": "Version",
                    "type": "object",
                    "properties": {
                        "expand": {
                            "type": "string"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "archived": {
                            "type": "boolean"
                        },
                        "released": {
                            "type": "boolean"
                        },
                        "overdue": {
                            "type": "boolean"
                        },
                        "userStartDate": {
                            "type": "string"
                        },
                        "userReleaseDate": {
                            "type": "string"
                        },
                        "project": {
                            "type": "string"
                        },
                        "projectId": {
                            "type": "integer"
                        },
                        "moveUnfixedIssuesTo": {
                            "type": "string",
                            "format": "uri"
                        },
                        "operations": {
                            "type": "array",
                            "items": {
                                "title": "Simple Link",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "string"
                                    },
                                    "styleClass": {
                                        "type": "string"
                                    },
                                    "iconClass": {
                                        "type": "string"
                                    },
                                    "label": {
                                        "type": "string"
                                    },
                                    "title": {
                                        "type": "string"
                                    },
                                    "href": {
                                        "type": "string"
                                    },
                                    "weight": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "remotelinks": {
                            "type": "array",
                            "items": {
                                "title": "Remote Entity Link",
                                "type": "object",
                                "properties": {
                                    "self": {
                                        "type": "string",
                                        "format": "uri"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "link": {}
                                },
                                "additionalProperties": false
                            }
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false,
        "required": [
            "maxResults",
            "startAt"
        ]
    }
  • 状态404
    返回如果项目没有找到,或者调用用户没有权限查看。

包含一个指定的项目版本的完整表示。

请求
查询参数
参数 类型 描述
expand

参数扩大

回复
  • 状态200 - 应用程序/ JSON
    如果项目存在,并且用户有权查看其版本返回。 包含JSON格式的项目版本的完整表示。
    [
        {
            "self": "http://www.example.com/jira/rest/api/2/version/10000",
            "id": "10000",
            "description": "An excellent version",
            "name": "New Version 1",
            "archived": false,
            "released": true,
            "releaseDate": "2010-07-06",
            "overdue": true,
            "userReleaseDate": "6/Jul/2010",
            "projectId": 10000
        },
        {
            "self": "http://www.example.com/jira/rest/api/2/version/10010",
            "id": "10010",
            "description": "Minor Bugfix version",
            "name": "Next Version",
            "archived": false,
            "released": false,
            "overdue": false,
            "projectId": 10000
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-version#",
        "title": "List of Version",
        "type": "array",
        "items": {
            "title": "Version",
            "type": "object",
            "properties": {
                "expand": {
                    "type": "string"
                },
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "id": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "archived": {
                    "type": "boolean"
                },
                "released": {
                    "type": "boolean"
                },
                "overdue": {
                    "type": "boolean"
                },
                "userStartDate": {
                    "type": "string"
                },
                "userReleaseDate": {
                    "type": "string"
                },
                "project": {
                    "type": "string"
                },
                "projectId": {
                    "type": "integer"
                },
                "moveUnfixedIssuesTo": {
                    "type": "string",
                    "format": "uri"
                },
                "operations": {
                    "type": "array",
                    "items": {
                        "title": "Simple Link",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "styleClass": {
                                "type": "string"
                            },
                            "iconClass": {
                                "type": "string"
                            },
                            "label": {
                                "type": "string"
                            },
                            "title": {
                                "type": "string"
                            },
                            "href": {
                                "type": "string"
                            },
                            "weight": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "remotelinks": {
                    "type": "array",
                    "items": {
                        "title": "Remote Entity Link",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string",
                                "format": "uri"
                            },
                            "name": {
                                "type": "string"
                            },
                            "link": {}
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false
        }
    }
  • 状态404
    返回如果项目没有找到,或者调用用户没有权限查看。

API / 2 /项目/ {} projectIdOrKey /属性隐藏所有方法

返回由键或用id标识项目的所有属性的钥匙。

回复
  • 状态200 - 应用程序/ JSON
    如果该项目被发现返回。
    {
        "keys": [
            {
                "self": "http://www.example.com/jira/rest/api/2/issue/EX-2/properties/issue.support",
                "key": "issue.support"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-properties-keys#",
        "title": "Entity Properties Keys",
        "type": "object",
        "properties": {
            "keys": {
                "type": "array",
                "items": {
                    "title": "Entity Property Key",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "key": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果项目键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    返回如果主叫用户不具有权限浏览的项目。
  • 状态404
    如果返回与给定的密钥或ID的项目不存在,或者给定键的属性是找不到的。

移除按键式或由id标识的项目属性。 THS用户删除属性是需要有权限来管理该项目。

回复
  • 状态400
    返回如果项目键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态204
    如果返回成功删除项目属性。
  • 状态403
    如果返回调用用户没有权限编辑该项目。
  • 状态404
    如果返回与给定的密钥或ID的项目不存在,或者给定键的属性是找不到的。

设置指定项目的属性的值。

你可以使用这个资源来存储反对键或用id标识项目中的自定义数据。 谁存储数据的用户需要具有的权限来管理项目。

回复
  • 状态200
    返回如果项目属性成功更新。
  • 状态201
    如果成功创建项目属性返回。
  • 状态400
    返回如果项目键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    返回如果主叫用户不具有权限管理项目。
  • 状态404
    如果与给定的密钥或ID的项目不存在,则返回。

返回与从由键或由id标识的项目的给定键的属性的值。 谁检索属性的用户需要具有的权限来读取该项目。

回复
  • 状态200 - 应用程序/ JSON
    如果项目财产被发现返回。
    {
        "key": "issue.support",
        "value": {
            "hipchat.room.id": "support-123",
            "support.time": "1m"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-property#",
        "title": "Entity Property",
        "type": "object",
        "properties": {
            "key": {
                "type": "string"
            },
            "value": {}
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果项目键或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    返回如果主叫用户不具有权限浏览的项目。
  • 状态404
    如果返回与给定的密钥或ID的项目不存在,或者给定键的属性是找不到的。

API / 2 /项目/ {} projectIdOrKey /角色隐藏所有方法

返回给定项目的ID或键的所有角色,链接到每个角色的全部细节。

回复
  • 状态200 - 应用程序/ JSON
    返回地图的角色包含每个角色的全部细节的URI一个。 该项目必须存在,并且用户必须有权限查看。
    {
        "Administrators": "http://www.example.com/jira/rest/api/2/project/MKY/role/10002",
        "Users": "http://www.example.com/jira/rest/api/2/project/MKY/role/10001",
        "Developers": "http://www.example.com/jira/rest/api/2/project/MKY/role/10000"
    }
    架构
    {
        "type": "object",
        "patternProperties": {
            ".+": {
                "type": "string",
                "format": "uri"
            }
        },
        "additionalProperties": false
    }
  • 状态404
    返回如果项目没有找到,或者调用用户没有权限查看。

返回在一个项目中某一项目的角色的细节。

回复
  • 状态200 - 应用程序/ JSON
    返回角色名称,描述和项目参与者所请求的角色(用户和组)。 该项目必须存在,并且用户必须有权限查看。
    {
        "self": "http://www.example.com/jira/rest/api/2/project/MKY/role/10360",
        "name": "Developers",
        "id": 10360,
        "description": "A project role that represents developers in a project",
        "actors": [
            {
                "id": 10240,
                "displayName": "jira-developers",
                "type": "atlassian-group-role-actor",
                "name": "jira-developers"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-role#",
        "title": "Project Role",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "description": {
                "type": "string"
            },
            "actors": {
                "type": "array",
                "items": {
                    "title": "Role Actor",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "type": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "avatarUrl": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态404
    返回如果项目或角色没有找到,或者调用用户没有权限查看。

更新项目的角色,包括指定的参与者(用户或组)。

请求
{
    "id": 10360,
    "categorisedActors": {
        "atlassian-user-role-actor": [
            "admin"
        ],
        "atlassian-group-role-actor": [
            "jira-developers"
        ]
    }
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/project-role-actors-update#",
    "title": "Project Role Actors Update",
    "type": "object",
    "properties": {
        "id": {
            "type": "integer"
        },
        "categorisedActors": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                }
            },
            "additionalProperties": false
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    返回角色名称,描述和项目参与者所请求的角色(用户和组)。 该项目必须存在,并且用户必须有权限查看。
    {
        "self": "http://www.example.com/jira/rest/api/2/project/MKY/role/10360",
        "name": "Developers",
        "id": 10360,
        "description": "A project role that represents developers in a project",
        "actors": [
            {
                "id": 10240,
                "displayName": "jira-developers",
                "type": "atlassian-group-role-actor",
                "name": "jira-developers"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-role#",
        "title": "Project Role",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "description": {
                "type": "string"
            },
            "actors": {
                "type": "array",
                "items": {
                    "title": "Role Actor",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "type": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "avatarUrl": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果返回演员不能添加到项目中的作用

添加一个演员(用户或组)到项目的作用。

请求
{ "user" : ["admin"] }  or
 { "group" : ["jira-developers"] }
架构
{
    "type": "object",
    "patternProperties": {
        ".+": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    返回角色名称,描述和项目参与者所请求的角色(用户和组)。 该项目必须存在,并且用户必须有权限查看。
    {
        "self": "http://www.example.com/jira/rest/api/2/project/MKY/role/10360",
        "name": "Developers",
        "id": 10360,
        "description": "A project role that represents developers in a project",
        "actors": [
            {
                "id": 10240,
                "displayName": "jira-developers",
                "type": "atlassian-group-role-actor",
                "name": "jira-developers"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-role#",
        "title": "Project Role",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "description": {
                "type": "string"
            },
            "actors": {
                "type": "array",
                "items": {
                    "title": "Role Actor",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "type": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "avatarUrl": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果返回演员不能添加到项目中的作用

从项目的角色删除角色(用户或组)。

  • 删除角色的用户: /rest/api/2/project/{projectIdOrKey}/role/{roleId}?user={username}
  • 删除该角色的组: /rest/api/2/project/{projectIdOrKey}/role/{roleId}?group={groupname}

请求
查询参数
参数 类型 描述
user

用户名从该项目中删除角色

group

该组名从该项目中删除角色

回复
  • 状态204
    如果演员被成功地从项目角色中删除返回。
  • 状态404
    返回如果项目或角色没有找到,主叫用户无权查看,或没有权限修改演员在项目中的角色。

API / 2 /项目/ {} projectKeyOrId / issuesecuritylevelscheme 隐藏所有方法

资源许可计划和项目联系起来。

返回项目问题的安全方案。

回复
  • 状态200 - 应用程序/ JSON
    如果用户具有管理员权限,或如果方案中,其中用户具有管理权限的一个项目使用的返回。
    {
        "self": "http://www.example.com/jira/rest/api/2/issuesecurityschemes/1000",
        "id": 1000,
        "name": "Default Issue Security Scheme",
        "description": "Description for the default issue security scheme",
        "defaultSecurityLevelId": 10021,
        "levels": [
            {
                "self": "http://www.example.com/jira/rest/api/2/securitylevel/10021",
                "id": "10021",
                "description": "Only the reporter and internal staff can see this issue.",
                "name": "Reporter Only"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/security-scheme#",
        "title": "Security Scheme",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultSecurityLevelId": {
                "type": "integer"
            },
            "levels": {
                "type": "array",
                "items": {
                    "title": "Security Level",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果用户没有登录。
  • 状态403
    返回如果项目是主叫用户可见,但用户不具有管理权限
  • 状态404
    返回如果该项目不存在,或者不是给主叫用户可见

API / 2 /项目/ {} projectKeyOrId / notificationscheme 隐藏所有方法

资源的通知计划和项目联系起来。

获取与项目相关的通知计划。 遵循/ notificationscheme / {ID}资源的文档,了解有关返回值的所有细节。

请求
查询参数
参数 类型 描述
expand
回复
  • 状态200 - 应用程序/ JSON
    如果通知方式存在,并且是可见的主叫用户返回
    {
        "expand": "notificationSchemeEvents,user,group,projectRole,field,all",
        "id": 10100,
        "self": "http://example.com/jira/rest/api/2/notificationscheme/10010",
        "name": "notification scheme name",
        "description": "description",
        "notificationSchemeEvents": [
            {
                "event": {
                    "id": 1,
                    "name": "Issue created",
                    "description": "Event published when issue is created"
                },
                "notifications": [
                    {
                        "id": 1,
                        "notificationType": "Group",
                        "parameter": "jira-administrators",
                        "group": {
                            "name": "jira-administrators",
                            "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-administrators"
                        },
                        "expand": "group"
                    },
                    {
                        "id": 2,
                        "notificationType": "CurrentAssignee"
                    },
                    {
                        "id": 3,
                        "notificationType": "ProjectRole",
                        "parameter": "10360",
                        "projectRole": {
                            "self": "http://www.example.com/jira/rest/api/2/project/MKY/role/10360",
                            "name": "Developers",
                            "id": 10360,
                            "description": "A project role that represents developers in a project",
                            "actors": [
                                {
                                    "id": 10240,
                                    "displayName": "jira-developers",
                                    "type": "atlassian-group-role-actor",
                                    "name": "jira-developers"
                                }
                            ]
                        },
                        "expand": "projectRole"
                    },
                    {
                        "id": 4,
                        "notificationType": "EmailAddress",
                        "parameter": "rest-developer@atlassian.com",
                        "emailAddress": "rest-developer@atlassian.com"
                    },
                    {
                        "id": 5,
                        "notificationType": "User",
                        "user": {
                            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                            "name": "fred",
                            "displayName": "Fred F. User",
                            "active": false
                        },
                        "expand": "user"
                    },
                    {
                        "id": 6,
                        "notificationType": "GroupCustomField",
                        "parameter": "customfield_10101",
                        "field": {
                            "id": "customfield_10101",
                            "name": "New custom field",
                            "custom": true,
                            "orderable": true,
                            "navigable": true,
                            "searchable": true,
                            "clauseNames": [
                                "cf[10101]",
                                "New custom field"
                            ],
                            "schema": {
                                "type": "project",
                                "custom": "com.atlassian.jira.plugin.system.customfieldtypes:project",
                                "customId": 10101
                            }
                        },
                        "expand": "field"
                    }
                ]
            },
            {
                "event": {
                    "id": 20,
                    "name": "Custom event",
                    "description": "Custom event which is published together with issue created event",
                    "templateEvent": {
                        "id": 1,
                        "name": "Issue created",
                        "description": "Event published when issue is created"
                    }
                },
                "notifications": [
                    {
                        "id": 1,
                        "notificationType": "Group",
                        "parameter": "jira-administrators",
                        "group": {
                            "name": "jira-administrators",
                            "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-administrators"
                        },
                        "expand": "group"
                    },
                    {
                        "id": 2,
                        "notificationType": "CurrentAssignee"
                    },
                    {
                        "id": 3,
                        "notificationType": "ProjectRole",
                        "parameter": "10360",
                        "projectRole": {
                            "self": "http://www.example.com/jira/rest/api/2/project/MKY/role/10360",
                            "name": "Developers",
                            "id": 10360,
                            "description": "A project role that represents developers in a project",
                            "actors": [
                                {
                                    "id": 10240,
                                    "displayName": "jira-developers",
                                    "type": "atlassian-group-role-actor",
                                    "name": "jira-developers"
                                }
                            ]
                        },
                        "expand": "projectRole"
                    },
                    {
                        "id": 4,
                        "notificationType": "EmailAddress",
                        "parameter": "rest-developer@atlassian.com",
                        "emailAddress": "rest-developer@atlassian.com"
                    },
                    {
                        "id": 5,
                        "notificationType": "User",
                        "user": {
                            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
                            "name": "fred",
                            "displayName": "Fred F. User",
                            "active": false
                        },
                        "expand": "user"
                    },
                    {
                        "id": 6,
                        "notificationType": "GroupCustomField",
                        "parameter": "customfield_10101",
                        "field": {
                            "id": "customfield_10101",
                            "name": "New custom field",
                            "custom": true,
                            "orderable": true,
                            "navigable": true,
                            "searchable": true,
                            "clauseNames": [
                                "cf[10101]",
                                "New custom field"
                            ],
                            "schema": {
                                "type": "project",
                                "custom": "com.atlassian.jira.plugin.system.customfieldtypes:project",
                                "customId": 10101
                            }
                        },
                        "expand": "field"
                    }
                ]
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/notification-scheme#",
        "title": "Notification Scheme",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "self": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "notificationSchemeEvents": {
                "type": "array",
                "items": {
                    "title": "Notification Scheme Event",
                    "type": "object",
                    "properties": {
                        "event": {
                            "$ref": "#/definitions/notification-event"
                        },
                        "notifications": {
                            "type": "array",
                            "items": {
                                "title": "Notification",
                                "type": "object",
                                "anyOf": [
                                    {
                                        "$ref": "#/definitions/custom-field-value-notification"
                                    },
                                    {
                                        "$ref": "#/definitions/email-notification"
                                    },
                                    {
                                        "$ref": "#/definitions/group-notification"
                                    },
                                    {
                                        "$ref": "#/definitions/project-role-notification"
                                    },
                                    {
                                        "$ref": "#/definitions/role-notification"
                                    },
                                    {
                                        "$ref": "#/definitions/user-notification"
                                    }
                                ]
                            }
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "definitions": {
            "custom-field-value-notification": {
                "title": "Custom Field Value Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "field": {
                        "title": "Field",
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "custom": {
                                "type": "boolean"
                            },
                            "orderable": {
                                "type": "boolean"
                            },
                            "navigable": {
                                "type": "boolean"
                            },
                            "searchable": {
                                "type": "boolean"
                            },
                            "clauseNames": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "schema": {
                                "title": "Json Type",
                                "type": "object",
                                "properties": {
                                    "type": {
                                        "type": "string"
                                    },
                                    "items": {
                                        "type": "string"
                                    },
                                    "system": {
                                        "type": "string"
                                    },
                                    "custom": {
                                        "type": "string"
                                    },
                                    "customId": {
                                        "type": "integer"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "email-notification": {
                "title": "Email Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "group-notification": {
                "title": "Group Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "group": {
                        "title": "Group",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            },
                            "self": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "notification-event": {
                "title": "Notification Event",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "name": {
                        "type": "string"
                    },
                    "description": {
                        "type": "string"
                    },
                    "templateEvent": {
                        "$ref": "#/definitions/notification-event"
                    }
                },
                "additionalProperties": false
            },
            "project-role-notification": {
                "title": "Project Role Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "projectRole": {
                        "title": "Project Role",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string",
                                "format": "uri"
                            },
                            "name": {
                                "type": "string"
                            },
                            "id": {
                                "type": "integer"
                            },
                            "description": {
                                "type": "string"
                            },
                            "actors": {
                                "type": "array",
                                "items": {
                                    "title": "Role Actor",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "integer"
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "type": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "avatarUrl": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            }
                        },
                        "additionalProperties": false
                    }
                },
                "additionalProperties": false
            },
            "role-notification": {
                "title": "Role Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "user-notification": {
                "title": "User Notification",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "notificationType": {
                        "type": "string"
                    },
                    "parameter": {
                        "type": "string"
                    },
                    "expand": {
                        "type": "string"
                    },
                    "user": {
                        "title": "User",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "key": {
                                "type": "string"
                            },
                            "emailAddress": {
                                "type": "string"
                            },
                            "avatarUrls": {
                                "type": "object",
                                "patternProperties": {
                                    ".+": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            },
                            "displayName": {
                                "type": "string"
                            },
                            "active": {
                                "type": "boolean"
                            },
                            "timeZone": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "active"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果用户没有登录。
  • 状态403
    如果用户被允许访问该项目,但不是项目或JIRA的管理员,因此不能看到该项目的通知方案返回。
  • 状态404
    返回如果通知方案不存在,或者是不向主叫用户可见

API / 2 /项目/ {} projectKeyOrId / permissionscheme 隐藏所有方法

资源许可计划和项目联系起来。

分配与项目许可方案。

请求
查询参数
参数 类型 描述
expand
{
    "id": 10000
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/id#",
    "title": "Id",
    "type": "object",
    "properties": {
        "id": {
            "type": "integer"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    新关联的许可计划的细节缩短。
    {
        "id": 10000,
        "self": "http://www.example.com/jira/rest/api/2/permissionscheme/10000",
        "name": "Example permission scheme",
        "description": "description"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/permission-scheme#",
        "title": "Permission Scheme",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "permissions": {
                "type": "array",
                "items": {
                    "title": "Permission Grant",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "holder": {
                            "title": "Permission Holder",
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string"
                                },
                                "parameter": {
                                    "type": "string"
                                },
                                "user": {
                                    "title": "User",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "key": {
                                            "type": "string"
                                        },
                                        "emailAddress": {
                                            "type": "string"
                                        },
                                        "avatarUrls": {
                                            "type": "object",
                                            "patternProperties": {
                                                ".+": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "active": {
                                            "type": "boolean"
                                        },
                                        "timeZone": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "active"
                                    ]
                                },
                                "group": {
                                    "title": "Group",
                                    "type": "object",
                                    "properties": {
                                        "name": {
                                            "type": "string"
                                        },
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "field": {
                                    "title": "Field",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "custom": {
                                            "type": "boolean"
                                        },
                                        "orderable": {
                                            "type": "boolean"
                                        },
                                        "navigable": {
                                            "type": "boolean"
                                        },
                                        "searchable": {
                                            "type": "boolean"
                                        },
                                        "clauseNames": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        },
                                        "schema": {
                                            "title": "Json Type",
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                },
                                                "items": {
                                                    "type": "string"
                                                },
                                                "system": {
                                                    "type": "string"
                                                },
                                                "custom": {
                                                    "type": "string"
                                                },
                                                "customId": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectRole": {
                                    "title": "Project Role",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "id": {
                                            "type": "integer"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "actors": {
                                            "type": "array",
                                            "items": {
                                                "title": "Role Actor",
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "displayName": {
                                                        "type": "string"
                                                    },
                                                    "type": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "avatarUrl": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "expand": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "permission": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果用户没有登录。
  • 状态403
    返回如果用户没有权限编辑项目的许可计划。 在实践中,用户需要一个JIRA管理员。
  • 状态404
    如果项目或许可方案未找到返回。

获取与项目中分配权限方案。

请求
查询参数
参数 类型 描述
expand
回复
  • 状态200 - 应用程序/ JSON
    相关的许可方案。
    {
        "id": 10000,
        "self": "http://www.example.com/jira/rest/api/2/permissionscheme/10000",
        "name": "Example permission scheme",
        "description": "description"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/permission-scheme#",
        "title": "Permission Scheme",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "permissions": {
                "type": "array",
                "items": {
                    "title": "Permission Grant",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "holder": {
                            "title": "Permission Holder",
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string"
                                },
                                "parameter": {
                                    "type": "string"
                                },
                                "user": {
                                    "title": "User",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "key": {
                                            "type": "string"
                                        },
                                        "emailAddress": {
                                            "type": "string"
                                        },
                                        "avatarUrls": {
                                            "type": "object",
                                            "patternProperties": {
                                                ".+": {
                                                    "type": "string"
                                                }
                                            },
                                            "additionalProperties": false
                                        },
                                        "displayName": {
                                            "type": "string"
                                        },
                                        "active": {
                                            "type": "boolean"
                                        },
                                        "timeZone": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false,
                                    "required": [
                                        "active"
                                    ]
                                },
                                "group": {
                                    "title": "Group",
                                    "type": "object",
                                    "properties": {
                                        "name": {
                                            "type": "string"
                                        },
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "field": {
                                    "title": "Field",
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "custom": {
                                            "type": "boolean"
                                        },
                                        "orderable": {
                                            "type": "boolean"
                                        },
                                        "navigable": {
                                            "type": "boolean"
                                        },
                                        "searchable": {
                                            "type": "boolean"
                                        },
                                        "clauseNames": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            }
                                        },
                                        "schema": {
                                            "title": "Json Type",
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                },
                                                "items": {
                                                    "type": "string"
                                                },
                                                "system": {
                                                    "type": "string"
                                                },
                                                "custom": {
                                                    "type": "string"
                                                },
                                                "customId": {
                                                    "type": "integer"
                                                }
                                            },
                                            "additionalProperties": false
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "projectRole": {
                                    "title": "Project Role",
                                    "type": "object",
                                    "properties": {
                                        "self": {
                                            "type": "string",
                                            "format": "uri"
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "id": {
                                            "type": "integer"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "actors": {
                                            "type": "array",
                                            "items": {
                                                "title": "Role Actor",
                                                "type": "object",
                                                "properties": {
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "displayName": {
                                                        "type": "string"
                                                    },
                                                    "type": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "avatarUrl": {
                                                        "type": "string",
                                                        "format": "uri"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        }
                                    },
                                    "additionalProperties": false
                                },
                                "expand": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "permission": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果用户没有登录。
  • 状态403
    返回如果用户没有权限查看该项目的配置。 在实践中,用户需要一个JRA管理员或项目管理员联系,获得分配的权限方案。
  • 状态404
    返回如果项目未找到(或用户没有权限查看项目)。

API / 2 /项目/ {} projectKeyOrId / securitylevel中隐藏的所有方法

提供对当前用户的给定项目的安全级别的信息。

返回当前登录的用户可以访问项目的所有安全级别。 如果用户没有设置问题安全许可,列表是空的。

回复
  • 状态200 - 应用程序/ JSON
    返回的量,当前用户具有访问一个项目中的所有安全级别的列表。
    {
        "levels": [
            {
                "self": "http://www.example.com/jira/rest/api/2/securitylevel/100000",
                "id": "100000",
                "description": "security description",
                "name": "securityLevelName"
            },
            {
                "self": "http://www.example.com/jira/rest/api/2/securitylevel/100001",
                "id": "100001",
                "description": "another security description",
                "name": "secret"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/security-list-level#",
        "title": "Security List Level",
        "type": "object",
        "properties": {
            "levels": {
                "type": "array",
                "items": {
                    "title": "Security Level",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态404
    或者返回如果项目未找到该用户没有权限浏览它。

API / 2 /项目/类型隐藏所有方法

返回所有在JIRA实例定义,没有考虑到许可证是否使用这些项目类型是否有效的项目类型。

回复
  • 状态200 - 应用程序/ JSON
    返回的JIRA实例定义的所有项目类型的列表。
    [
        {
            "key": "business",
            "formattedKey": "Business",
            "descriptionI18nKey": "Project type for business projects",
            "icon": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjwhLS0gR2VuZXJhdG9yOiBBZG9iZSBJbGx1c3RyYXRvciAxOC4xLjEsIFNWRyBFeHBvcnQgUGx1Zy1JbiAuIFNWRyBWZXJzaW9uOiA2LjAwIEJ1aWxkIDApICAtLT4NCjxzdmcgdmVyc2lvbj0iMS4xIiBpZD0iTGF5ZXJfMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayIgeD0iMHB4IiB5PSIwcHgiDQoJIHZpZXdCb3g9IjAgMCAzMiAzMiIgZW5hYmxlLWJhY2tncm91bmQ9Im5ldyAwIDAgMzIgMzIiIHhtbDpzcGFjZT0icHJlc2VydmUiPg0KPGc+DQoJPHBhdGggZmlsbD0iIzY2NjY2NiIgZD0iTTE2LDBDNy4yLDAsMCw3LjIsMCwxNmMwLDguOCw3LjIsMTYsMTYsMTZjOC44LDAsMTYtNy4yLDE2LTE2QzMyLDcuMiwyNC44LDAsMTYsMHogTTI1LjcsMjMNCgkJYzAsMS44LTEuNCwzLjItMy4yLDMuMkg5LjJDNy41LDI2LjIsNiwyNC44LDYsMjNWOS44QzYsOCw3LjUsNi42LDkuMiw2LjZoMTMuMmMwLjIsMCwwLjQsMCwwLjcsMC4xbC0yLjgsMi44SDkuMg0KCQlDOSw5LjQsOC44LDkuNiw4LjgsOS44VjIzYzAsMC4yLDAuMiwwLjQsMC40LDAuNGgxMy4yYzAuMiwwLDAuNC0wLjIsMC40LTAuNHYtNS4zbDIuOC0yLjhWMjN6IE0xNS45LDIxLjNMMTEsMTYuNGwyLTJsMi45LDIuOQ0KCQlMMjYuNCw2LjhjMC42LDAuNywxLjIsMS41LDEuNywyLjNMMTUuOSwyMS4zeiIvPg0KPC9nPg0KPC9zdmc+",
            "color": "#FFFFFF"
        },
        {
            "key": "software",
            "formattedKey": "Software",
            "descriptionI18nKey": "Project type for software projects",
            "icon": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjwhLS0gR2VuZXJhdG9yOiBBZG9iZSBJbGx1c3RyYXRvciAxOC4xLjEsIFNWRyBFeHBvcnQgUGx1Zy1JbiAuIFNWRyBWZXJzaW9uOiA2LjAwIEJ1aWxkIDApICAtLT4NCjxzdmcgdmVyc2lvbj0iMS4xIiBpZD0iTGF5ZXJfMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayIgeD0iMHB4IiB5PSIwcHgiDQoJIHZpZXdCb3g9IjAgMCAzMiAzMiIgZW5hYmxlLWJhY2tncm91bmQ9Im5ldyAwIDAgMzIgMzIiIHhtbDpzcGFjZT0icHJlc2VydmUiPg0KPGc+DQoJPHBhdGggZmlsbD0iIzY2NjY2NiIgZD0iTTE2LDBDNy4yLDAsMCw3LjIsMCwxNmMwLDguOCw3LjIsMTYsMTYsMTZjOC44LDAsMTYtNy4yLDE2LTE2QzMyLDcuMiwyNC44LDAsMTYsMHogTTI1LjcsMjMNCgkJYzAsMS44LTEuNCwzLjItMy4yLDMuMkg5LjJDNy41LDI2LjIsNiwyNC44LDYsMjNWOS44QzYsOCw3LjUsNi42LDkuMiw2LjZoMTMuMmMwLjIsMCwwLjQsMCwwLjcsMC4xbC0yLjgsMi44SDkuMg0KCQlDOSw5LjQsOC44LDkuNiw4LjgsOS44VjIzYzAsMC4yLDAuMiwwLjQsMC40LDAuNGgxMy4yYzAuMiwwLDAuNC0wLjIsMC40LTAuNHYtNS4zbDIuOC0yLjhWMjN6IE0xNS45LDIxLjNMMTEsMTYuNGwyLTJsMi45LDIuOQ0KCQlMMjYuNCw2LjhjMC42LDAuNywxLjIsMS41LDEuNywyLjNMMTUuOSwyMS4zeiIvPg0KPC9nPg0KPC9zdmc+",
            "color": "#AAAAAA"
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-project-type#",
        "title": "List of Project Type",
        "type": "array",
        "items": {
            "title": "Project Type",
            "type": "object",
            "properties": {
                "key": {
                    "type": "string"
                },
                "formattedKey": {
                    "type": "string"
                },
                "descriptionI18nKey": {
                    "type": "string"
                },
                "icon": {
                    "type": "string"
                },
                "color": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    }

返回与给定键的项目类型。

回复
  • 状态200 - 应用程序/ JSON
    返回项目类型的表示指定id
    {
        "key": "business",
        "formattedKey": "Business",
        "descriptionI18nKey": "Project type for business projects",
        "icon": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjwhLS0gR2VuZXJhdG9yOiBBZG9iZSBJbGx1c3RyYXRvciAxOC4xLjEsIFNWRyBFeHBvcnQgUGx1Zy1JbiAuIFNWRyBWZXJzaW9uOiA2LjAwIEJ1aWxkIDApICAtLT4NCjxzdmcgdmVyc2lvbj0iMS4xIiBpZD0iTGF5ZXJfMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayIgeD0iMHB4IiB5PSIwcHgiDQoJIHZpZXdCb3g9IjAgMCAzMiAzMiIgZW5hYmxlLWJhY2tncm91bmQ9Im5ldyAwIDAgMzIgMzIiIHhtbDpzcGFjZT0icHJlc2VydmUiPg0KPGc+DQoJPHBhdGggZmlsbD0iIzY2NjY2NiIgZD0iTTE2LDBDNy4yLDAsMCw3LjIsMCwxNmMwLDguOCw3LjIsMTYsMTYsMTZjOC44LDAsMTYtNy4yLDE2LTE2QzMyLDcuMiwyNC44LDAsMTYsMHogTTI1LjcsMjMNCgkJYzAsMS44LTEuNCwzLjItMy4yLDMuMkg5LjJDNy41LDI2LjIsNiwyNC44LDYsMjNWOS44QzYsOCw3LjUsNi42LDkuMiw2LjZoMTMuMmMwLjIsMCwwLjQsMCwwLjcsMC4xbC0yLjgsMi44SDkuMg0KCQlDOSw5LjQsOC44LDkuNiw4LjgsOS44VjIzYzAsMC4yLDAuMiwwLjQsMC40LDAuNGgxMy4yYzAuMiwwLDAuNC0wLjIsMC40LTAuNHYtNS4zbDIuOC0yLjhWMjN6IE0xNS45LDIxLjNMMTEsMTYuNGwyLTJsMi45LDIuOQ0KCQlMMjYuNCw2LjhjMC42LDAuNywxLjIsMS41LDEuNywyLjNMMTUuOSwyMS4zeiIvPg0KPC9nPg0KPC9zdmc+",
        "color": "#FFFFFF"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-type#",
        "title": "Project Type",
        "type": "object",
        "properties": {
            "key": {
                "type": "string"
            },
            "formattedKey": {
                "type": "string"
            },
            "descriptionI18nKey": {
                "type": "string"
            },
            "icon": {
                "type": "string"
            },
            "color": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }

返回与给定键的项目类型,如果是要登录的用户访问。 这考虑到了用户是否在定义的项目类型的应用程序的许可。

回复
  • 状态200 - 应用程序/ JSON
    返回项目类型的表示指定id
    {
        "key": "business",
        "formattedKey": "Business",
        "descriptionI18nKey": "Project type for business projects",
        "icon": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjwhLS0gR2VuZXJhdG9yOiBBZG9iZSBJbGx1c3RyYXRvciAxOC4xLjEsIFNWRyBFeHBvcnQgUGx1Zy1JbiAuIFNWRyBWZXJzaW9uOiA2LjAwIEJ1aWxkIDApICAtLT4NCjxzdmcgdmVyc2lvbj0iMS4xIiBpZD0iTGF5ZXJfMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayIgeD0iMHB4IiB5PSIwcHgiDQoJIHZpZXdCb3g9IjAgMCAzMiAzMiIgZW5hYmxlLWJhY2tncm91bmQ9Im5ldyAwIDAgMzIgMzIiIHhtbDpzcGFjZT0icHJlc2VydmUiPg0KPGc+DQoJPHBhdGggZmlsbD0iIzY2NjY2NiIgZD0iTTE2LDBDNy4yLDAsMCw3LjIsMCwxNmMwLDguOCw3LjIsMTYsMTYsMTZjOC44LDAsMTYtNy4yLDE2LTE2QzMyLDcuMiwyNC44LDAsMTYsMHogTTI1LjcsMjMNCgkJYzAsMS44LTEuNCwzLjItMy4yLDMuMkg5LjJDNy41LDI2LjIsNiwyNC44LDYsMjNWOS44QzYsOCw3LjUsNi42LDkuMiw2LjZoMTMuMmMwLjIsMCwwLjQsMCwwLjcsMC4xbC0yLjgsMi44SDkuMg0KCQlDOSw5LjQsOC44LDkuNiw4LjgsOS44VjIzYzAsMC4yLDAuMiwwLjQsMC40LDAuNGgxMy4yYzAuMiwwLDAuNC0wLjIsMC40LTAuNHYtNS4zbDIuOC0yLjhWMjN6IE0xNS45LDIxLjNMMTEsMTYuNGwyLTJsMi45LDIuOQ0KCQlMMjYuNCw2LjhjMC42LDAuNywxLjIsMS41LDEuNywyLjNMMTUuOSwyMS4zeiIvPg0KPC9nPg0KPC9zdmc+",
        "color": "#FFFFFF"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-type#",
        "title": "Project Type",
        "type": "object",
        "properties": {
            "key": {
                "type": "string"
            },
            "formattedKey": {
                "type": "string"
            },
            "descriptionI18nKey": {
                "type": "string"
            },
            "icon": {
                "type": "string"
            },
            "color": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    的401的响应状态表示有在用户不是一个记录,因此,不能进行该操作
  • 状态404
    404响应状态表明,项目类型是无法访问的登录用户

API / 2 / projectCategory 隐藏所有方法

通过创建一个POST项目类别。

请求
{
    "name": "CREATED",
    "description": "Created Project Category"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/project-category#",
    "title": "Project Category",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    如果成功创建项目类别返回。
    {
        "self": "http://www.example.com/jira/rest/api/2/projectCategory/10100",
        "id": "10100",
        "name": "CREATED",
        "description": "Created Project Category"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-category#",
        "title": "Project Category",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    如果调用者不那么登录没有权限创建项目类别返回。
  • 状态403
    返回如果调用者进行身份验证并没有权限创建项目类别(不是全局管理员)。
  • 状态409
    如果一个项目类别与给定的名称已经存在返回。

返回所有的项目类别

回复
  • 状态200 - 应用程序/ JSON
    返回项目的类别列表。
    [
        {
            "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
            "id": "10000",
            "name": "FIRST",
            "description": "First Project Category"
        },
        {
            "self": "http://www.example.com/jira/rest/api/2/projectCategory/10001",
            "id": "10001",
            "name": "SECOND",
            "description": "Second Project Category"
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-project-category#",
        "title": "List of Project Category",
        "type": "array",
        "items": {
            "title": "Project Category",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "id": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态500
    如果返回在检索的项目列表中会出现错误。

删除项目类别。

回复
  • 状态401
    如果调用者不那么登录没有权限删除项目类别返回。
  • 状态204
    返回如果项目类别被成功删除。
  • 状态403
    返回如果调用者进行身份验证并没有权限删除的项目类别(不是全局管理员)。
  • 状态404
    如果项目的类别不存在或当前身份验证的用户没有权限查看它返回。

通过PUT修改项目类别。 目前在把任何领域将覆盖现有值。 为方便起见,如果一个字段不存在,它被忽略。

请求
{
    "name": "UPDATED",
    "description": "Updated Project Category"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/project-category#",
    "title": "Project Category",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    如果项目类别存在返回,目前已验证的用户有权对其进行编辑。
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-category#",
        "title": "Project Category",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "id": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "name": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态201
    {
        "self": "http://www.example.com/jira/rest/api/2/projectCategory/10100",
        "id": "10100",
        "name": "UPDATED",
        "description": "Updated Project Category"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-category#",
        "title": "Project Category",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "id": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "name": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    如果调用者不那么登录没有权限更改项目类别返回。
  • 状态403
    返回如果调用者进行身份验证并没有权限更改项目类别(不是全局管理员)。
  • 状态404
    如果项目的类别不存在或当前身份验证的用户没有权限查看它返回。

包含JSON格式的项目类别的表示。

回复
  • 状态200 - 应用程序/ JSON
    如果项目类别存在返回。 包含JSON格式的项目类别的代表性。
    {
        "self": "http://www.example.com/jira/rest/api/2/projectCategory/10000",
        "id": "10000",
        "name": "FIRST",
        "description": "First Project Category"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-category#",
        "title": "Project Category",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果项目的类别不存在或当前身份验证的用户没有权限查看它返回。

API / 2 / projectvalidate 隐藏所有方法

验证项目的关键。

请求
查询参数
参数 类型 描述
key

项目关键

回复
  • 状态200 - 应用程序/ JSON
    返回包含项目关键任何验证错误的ErrorCollection。
    {
        "errorMessages": [],
        "errors": {
            "projectKey": "A project with that project key already exists."
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/error-collection#",
        "title": "Error Collection",
        "type": "object",
        "properties": {
            "errorMessages": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "errors": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "status": {
                "type": "integer"
            }
        },
        "additionalProperties": false
    }

API / 2 /重新索引隐藏所有方法

启动/停止/查询索引REST资源。

揭开序幕REINDEX。 需要管理员权限执行此REINDEX。

请求
查询参数
参数 类型 描述
type

不区分大小写字符串,表示重新索引类型。 如果省略,则默认为BACKGROUND_PREFERRED。

indexComments 布尔

默认值:

表示意见也应该重建索引。 对于前景重新索引,其中的意见总是重新索引不相关。

indexChangeHistory 布尔

默认值:

指示变更记录也应该重建索引。 对于前景重新索引,在变更记录总是重新索引不相关。

indexWorklogs 布尔

默认值:

指示变更记录也应该重建索引。 对于前景重新索引,在变更记录总是重新索引不相关。

回复
  • 状态202 - 应用程序/ JSON
    返回重新索引操作的进度表示。
    {
        "progressUrl": "http://localhost:8080/jira",
        "currentProgress": 0,
        "currentSubTask": "Currently reindexing Change History",
        "type": "FOREGROUND",
        "submittedTime": "2016-09-06T09:48:12.322+0000",
        "startTime": "2016-09-06T09:48:12.322+0000",
        "finishTime": "2016-09-06T09:48:12.322+0000",
        "success": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/reindex#",
        "title": "Reindex",
        "type": "object",
        "properties": {
            "progressUrl": {
                "type": "string"
            },
            "currentProgress": {
                "type": "integer"
            },
            "currentSubTask": {
                "type": "string"
            },
            "type": {
                "type": "string",
                "enum": [
                    "FOREGROUND",
                    "BACKGROUND",
                    "BACKGROUND_PREFFERED",
                    "BACKGROUND_PREFERRED"
                ]
            },
            "submittedTime": {
                "type": "string"
            },
            "startTime": {
                "type": "string"
            },
            "finishTime": {
                "type": "string"
            },
            "success": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "success"
        ]
    }

返回在系统重新索引信息。 如果重新索引目前正在进行,则返回这个REINDEX信息。 如果没有积极的指标任务,然后返回有关最新的重新索引任务运行信息,否则返回404表明没有重新索引已经发生。

请求
查询参数
参数 类型 描述
taskId

一个索引任务的ID您希望在获得详细信息。 如果省略,则默认为标准行为,并返回在活动重新索引任务,或者最后一个任务信息,如果没有重新索引正在发生运行。 如果没有与该ID不重建索引任务则404返回。

回复
  • 状态200 - 应用程序/ JSON
    返回重新索引操作的进度表示。
    {
        "progressUrl": "http://localhost:8080/jira",
        "currentProgress": 0,
        "currentSubTask": "Currently reindexing Change History",
        "type": "FOREGROUND",
        "submittedTime": "2016-09-06T09:48:12.322+0000",
        "startTime": "2016-09-06T09:48:12.322+0000",
        "finishTime": "2016-09-06T09:48:12.322+0000",
        "success": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/reindex#",
        "title": "Reindex",
        "type": "object",
        "properties": {
            "progressUrl": {
                "type": "string"
            },
            "currentProgress": {
                "type": "integer"
            },
            "currentSubTask": {
                "type": "string"
            },
            "type": {
                "type": "string",
                "enum": [
                    "FOREGROUND",
                    "BACKGROUND",
                    "BACKGROUND_PREFFERED",
                    "BACKGROUND_PREFERRED"
                ]
            },
            "submittedTime": {
                "type": "string"
            },
            "startTime": {
                "type": "string"
            },
            "finishTime": {
                "type": "string"
            },
            "success": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "success"
        ]
    }
  • 状态404
    返回如果发现没有重新索引任务

重新索引一个或多个单独的问题。 索引是同步进行 - 当的问题索引已完成或发生故障的调用返回。

请使用明确指定问题ID或一个JQL查询来选择问题重新索引。

请求
查询参数
参数 类型 描述
issueId

的ID或中的一个或多个问题的键重新索引。

indexComments 布尔

默认值:

表示意见也应该重建索引。

indexChangeHistory 布尔

默认值:

指示变更记录也应该重建索引。

indexWorklogs 布尔

默认值:

指示变更记录也应该重建索引。

回复
  • 状态202 - 应用程序/ JSON
    返回重新索引操作的进度表示。
    {
        "progressUrl": "http://localhost:8080/jira",
        "currentProgress": 0,
        "currentSubTask": "Currently reindexing Change History",
        "type": "FOREGROUND",
        "submittedTime": "2016-09-06T09:48:12.322+0000",
        "startTime": "2016-09-06T09:48:12.322+0000",
        "finishTime": "2016-09-06T09:48:12.322+0000",
        "success": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/reindex#",
        "title": "Reindex",
        "type": "object",
        "properties": {
            "progressUrl": {
                "type": "string"
            },
            "currentProgress": {
                "type": "integer"
            },
            "currentSubTask": {
                "type": "string"
            },
            "type": {
                "type": "string",
                "enum": [
                    "FOREGROUND",
                    "BACKGROUND",
                    "BACKGROUND_PREFFERED",
                    "BACKGROUND_PREFERRED"
                ]
            },
            "submittedTime": {
                "type": "string"
            },
            "startTime": {
                "type": "string"
            },
            "finishTime": {
                "type": "string"
            },
            "success": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "success"
        ]
    }

返回在系统重新索引信息。 如果重新索引目前正在进行,则返回这个REINDEX信息。 如果没有积极的指标任务,然后返回有关最新的重新索引任务运行信息,否则返回404表明没有重新索引已经发生。

请求
查询参数
参数 类型 描述
taskId

一个索引任务的ID您希望在获得详细信息。 如果省略,则默认为标准行为,并返回在活动重新索引任务,或者最后一个任务信息,如果没有重新索引正在发生运行。 如果没有与该ID不重建索引任务则404返回。

回复
  • 状态200 - 应用程序/ JSON
    返回重新索引操作的进度表示。
    {
        "progressUrl": "http://localhost:8080/jira",
        "currentProgress": 0,
        "currentSubTask": "Currently reindexing Change History",
        "type": "FOREGROUND",
        "submittedTime": "2016-09-06T09:48:12.322+0000",
        "startTime": "2016-09-06T09:48:12.322+0000",
        "finishTime": "2016-09-06T09:48:12.322+0000",
        "success": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/reindex#",
        "title": "Reindex",
        "type": "object",
        "properties": {
            "progressUrl": {
                "type": "string"
            },
            "currentProgress": {
                "type": "integer"
            },
            "currentSubTask": {
                "type": "string"
            },
            "type": {
                "type": "string",
                "enum": [
                    "FOREGROUND",
                    "BACKGROUND",
                    "BACKGROUND_PREFFERED",
                    "BACKGROUND_PREFERRED"
                ]
            },
            "submittedTime": {
                "type": "string"
            },
            "startTime": {
                "type": "string"
            },
            "finishTime": {
                "type": "string"
            },
            "success": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "success"
        ]
    }
  • 状态404
    返回如果发现没有重新索引任务

API / 2 /重新索引/请求隐藏所有方法

用于查询和执行REINDEX请求REST资源。

执行任何挂起REINDEX请求。 返回包含正在处理重新索引的请求ID的JSON阵列。 执行是异步 - 返回的任务进度可以通过其他REST调用进行监控。

回复
  • 状态200 - 应用程序/ JSON
    返回要处理包含重新索引请求ID阵列。
    架构
    {
        "type": "array",
        "items": {
            "type": "integer"
        }
    }

检索单个重新索引请求的进度。

回复
  • 状态200 - 应用程序/ JSON
    详情及重新索引要求的状态。
    {
        "id": 10500,
        "status": "PENDING",
        "type": "IMMEDIATE",
        "requestTime": "2016-09-06T09:48:12.303+0000"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/reindex-request#",
        "title": "Reindex Request",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "status": {
                "type": "string",
                "enum": [
                    "PENDING",
                    "ACTIVE",
                    "RUNNING",
                    "FAILED",
                    "COMPLETE"
                ]
            },
            "type": {
                "type": "string",
                "enum": [
                    "IMMEDIATE",
                    "DELAYED"
                ]
            },
            "requestTime": {
                "type": "string"
            },
            "startTime": {
                "type": "string"
            },
            "completionTime": {
                "type": "string"
            }
        },
        "additionalProperties": false,
        "required": [
            "id"
        ]
    }
  • 状态404
    如果没有这样的要求重新索引存在返回。

检索多个重新索引请求的进度。 只有实际存在REINDEX请求将在结果中返回。

请求
查询参数
参数 类型 描述
requestId

重新索引请求ID。

回复
  • 状态200 - 应用程序/ JSON
    详情及重新索引要求的状态。
    {
        "id": 10500,
        "status": "PENDING",
        "type": "IMMEDIATE",
        "requestTime": "2016-09-06T09:48:12.303+0000"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/reindex-request#",
        "title": "Reindex Request",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "status": {
                "type": "string",
                "enum": [
                    "PENDING",
                    "ACTIVE",
                    "RUNNING",
                    "FAILED",
                    "COMPLETE"
                ]
            },
            "type": {
                "type": "string",
                "enum": [
                    "IMMEDIATE",
                    "DELAYED"
                ]
            },
            "requestTime": {
                "type": "string"
            },
            "startTime": {
                "type": "string"
            },
            "completionTime": {
                "type": "string"
            }
        },
        "additionalProperties": false,
        "required": [
            "id"
        ]
    }

API / 2 /分辨率隐藏所有方法

返回所有分辨率的列表。

回复
  • 状态200 - 应用程序/ JSON
    如果决议存在,并且用户有权限查看它们返回。 包含JSON格式的分辨率的全表示。
    [
        {
            "self": "http://www.example.com/jira/rest/api/2/resolution/1",
            "description": "A fix for this issue is checked into the tree and tested.",
            "iconUrl": "http://www.example.com/jira/images/icons/statuses/resolved.png",
            "name": "Fixed"
        },
        {
            "self": "http://www.example.com/jira/rest/api/2/resolution/3",
            "description": "This is what it is supposed to do.",
            "name": "Works as designed"
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-resolution#",
        "title": "List of Resolution",
        "type": "array",
        "items": {
            "title": "Resolution",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "description": {
                    "type": "string"
                },
                "iconUrl": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "id": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    }

返回的决议。

回复
  • 状态200 - 应用程序/ JSON
    如果分辨率存在,并且用户有权限查看返回。 包含JSON格式的分辨率的全表示。
    {
        "self": "http://www.example.com/jira/rest/api/2/resolution/1",
        "description": "A fix for this issue is checked into the tree and tested.",
        "iconUrl": "http://www.example.com/jira/images/icons/statuses/resolved.png",
        "name": "Fixed"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/resolution#",
        "title": "Resolution",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "description": {
                "type": "string"
            },
            "iconUrl": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果分辨率不存在,或者用户没有权限查看它返回。

API / 2 /角色隐藏所有方法

得到JIRA所有可用ProjectRoles。 目前,这份名单是全球性的。

回复
  • 状态200
    返回如果用户通过验证
    {
        "name": "Developers",
        "id": 10360,
        "description": "A project role that represents developers in a project"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-role#",
        "title": "Project Role",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "description": {
                "type": "string"
            },
            "actors": {
                "type": "array",
                "items": {
                    "title": "Role Actor",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "type": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "avatarUrl": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果您没有权限,或者您还没有登录。
  • 状态403
    返回如果请求的用户是不是管理员或系统管理员。

创建一个新的ProjectRole在JIRA可用。 创建的角色没有分配任何默认角色。

请求
{
    "name": "MyRole",
    "description": "role description"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/create-update-role-request#",
    "title": "Create Update Role Request",
    "type": "object",
    "properties": {
        "description": {
            "type": "string"
        },
        "name": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    返回如果用户通过验证
    {
        "name": "Developers",
        "id": 10360,
        "description": "A project role that represents developers in a project"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-role#",
        "title": "Project Role",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "description": {
                "type": "string"
            },
            "actors": {
                "type": "array",
                "items": {
                    "title": "Role Actor",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "type": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "avatarUrl": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果请求JSON没有一个名称字段或名称字段是无效的(空或开始或结尾空格)
  • 状态401
    返回如果您还没有登录。
  • 状态403
    返回如果您没有权限来创建一个角色。
  • 状态409
    如果具有给定名称的角色已经存在返回。

得到JIRA提供特定ProjectRole。

回复
  • 状态200
    返回如果用户通过验证
    {
        "name": "Developers",
        "id": 10360,
        "description": "A project role that represents developers in a project"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-role#",
        "title": "Project Role",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "description": {
                "type": "string"
            },
            "actors": {
                "type": "array",
                "items": {
                    "title": "Role Actor",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "type": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "avatarUrl": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果您没有权限,或者您还没有登录。
  • 状态403
    返回如果请求的用户是不是管理员或系统管理员。
  • 状态404
    如果具有给定ID的角色不存在返回。

部分更新了角色名称或说明。

请求
{
    "name": "MyRole",
    "description": "role description"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/create-update-role-request#",
    "title": "Create Update Role Request",
    "type": "object",
    "properties": {
        "description": {
            "type": "string"
        },
        "name": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    返回如果更新成功
    {
        "name": "Developers",
        "id": 10360,
        "description": "A project role that represents developers in a project"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-role#",
        "title": "Project Role",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "description": {
                "type": "string"
            },
            "actors": {
                "type": "array",
                "items": {
                    "title": "Role Actor",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "type": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "avatarUrl": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态400
    当没有给出这两个名称和描述或名称字段是无效的(空或开始或结尾空格)返回。
  • 状态401
    返回,如果请求用户没有登录。
  • 状态403
    返回如果请求的用户是不是管理员或系统管理员。
  • 状态404
    如果具有给定ID的角色不存在返回。

全面更新了角色。 名称和说明应予重视。

请求
{
    "name": "MyRole",
    "description": "role description"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/create-update-role-request#",
    "title": "Create Update Role Request",
    "type": "object",
    "properties": {
        "description": {
            "type": "string"
        },
        "name": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    返回如果更新成功
    {
        "name": "Developers",
        "id": 10360,
        "description": "A project role that represents developers in a project"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-role#",
        "title": "Project Role",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "description": {
                "type": "string"
            },
            "actors": {
                "type": "array",
                "items": {
                    "title": "Role Actor",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "type": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "avatarUrl": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态400
    当没有给出返回名称或说明或名称字段是无效的(空或开始或结尾空格)
  • 状态401
    返回,如果请求用户没有登录。
  • 状态403
    返回如果请求的用户是不是管理员或系统管理员。
  • 状态404
    如果具有给定ID的角色不存在返回。

删除一个角色。 可能在未来返回403

请求
查询参数
参数 类型 描述
swap

如果给定的,删除由与给定的一个替换的作用,即使是在方案中使用的角色

回复
  • 状态400
    如果与给定的交换ID给角色不存在返回。
  • 状态401
    返回,如果请求用户没有登录。
  • 状态204
    返回如果删除成功。
  • 状态403
    返回如果请求的用户是不是管理员或系统管理员。
  • 状态404
    如果具有给定ID的角色不存在返回。
  • 状态409
    如果项目中的作用在方案中使用和roleToSwap查询参数没有给出返回。

获取给定角色的默认行为。

回复
  • 状态200
    返回如果用户通过验证
    {
        "actors": [
            {
                "id": 10240,
                "displayName": "jira-developers",
                "type": "atlassian-group-role-actor",
                "name": "jira-developers"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-role#",
        "title": "Project Role",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "description": {
                "type": "string"
            },
            "actors": {
                "type": "array",
                "items": {
                    "title": "Role Actor",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "type": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "avatarUrl": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回,如果请求用户没有登录。
  • 状态403
    返回如果请求的用户是不是管理员或系统管理员。
  • 状态404
    如果具有给定ID的角色不存在返回。

添加默认的演员给定角色。 请求数据应该包含用户名列表或组添加的列表。

请求
{
    "user": [
        "admin"
    ]
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/actor-input#",
    "title": "Actor Input",
    "type": "object",
    "properties": {
        "user": {
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "group": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    返回如果更新成功
    {
        "actors": [
            {
                "id": 10240,
                "displayName": "jira-developers",
                "type": "atlassian-group-role-actor",
                "name": "jira-developers"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/project-role#",
        "title": "Project Role",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "description": {
                "type": "string"
            },
            "actors": {
                "type": "array",
                "items": {
                    "title": "Role Actor",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "integer"
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "type": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "avatarUrl": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果返回的用户和组均给予或不给予或在各自的列表组或用户不存在。
  • 状态401
    返回,如果请求用户没有登录。
  • 状态403
    返回如果请求的用户是不是管理员或系统管理员。
  • 状态404
    如果具有给定ID的角色不存在返回。

移除给定角色默认演员。

请求
查询参数
参数 类型 描述
user

如果有,将删除给定角色的演员

group

如果有,将删除给定角色的演员

回复
  • 状态200
    返回如果更新成功。
    {
        "actors": [
            {
                "id": 10240,
                "displayName": "jira-developers",
                "type": "atlassian-group-role-actor",
                "name": "jira-developers"
            }
        ]
    }
  • 状态400
    如果返回的用户和组没有给出,用户和组给予或提供的组或用户不存在。
  • 状态401
    返回,如果请求用户没有登录。
  • 状态403
    返回如果请求的用户是不是管理员或系统管理员。
  • 状态404
    如果具有给定ID的角色不存在返回。

API / 2 /屏幕隐藏所有方法

获取屏幕可用字段。 那些尚未被添加,即那些。

回复
  • 状态200
    对于屏幕可用字段列表
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-screenable-tab#",
        "title": "List of Screenable Tab",
        "type": "array",
        "items": {
            "title": "Screenable Tab",
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态400
    如果屏幕不存在返回
  • 状态401
    如果您没有权限返回

创建选项卡定的屏幕

请求
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/screenable-tab#",
    "title": "Screenable Tab",
    "type": "object",
    "properties": {
        "id": {
            "type": "integer"
        },
        "name": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    在JSON新创建的标签。
    {
        "id": 10000,
        "name": "Fields Tab"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/screenable-tab#",
        "title": "Screenable Tab",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果返回屏幕不存在或标签名称无效
  • 状态401
    如果您没有权限返回

返回所有选项卡的列表,对于给定的屏幕

请求
查询参数
参数 类型 描述
projectKey

该项目的密钥; 此参数是可选

回复
  • 状态200 - 应用程序/ JSON
    包含JSON所有可见标签的完整表示。
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-screenable-tab#",
        "title": "List of Screenable Tab",
        "type": "array",
        "items": {
            "title": "Screenable Tab",
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态400
    如果屏幕不存在返回
  • 状态401
    如果您没有权限返回

鉴于重命名屏幕上的选项卡

请求
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/screenable-tab#",
    "title": "Screenable Tab",
    "type": "object",
    "properties": {
        "id": {
            "type": "integer"
        },
        "name": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    改性JSON标签。
    {
        "id": 10000,
        "name": "Fields Tab"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/screenable-tab#",
        "title": "Screenable Tab",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果返回屏幕不存在或标签名称无效
  • 状态401
    如果您没有权限返回

删除选项卡给屏幕

回复
  • 状态201
    已成功删除标签
  • 状态400
    如果屏幕或选项卡不存在,则返回
  • 状态401
    如果您没有权限返回

添加字段给定的标签。

请求
{
    "fieldId": "summary"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/add-field#",
    "title": "Add Field",
    "type": "object",
    "properties": {
        "fieldId": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    新增字段作为JSON
    {
        "id": "summary",
        "name": "Summary"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/screenable-field#",
        "title": "Screenable Field",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "name": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果屏幕,选项卡或字段不存在返回。
  • 状态401
    如果您没有权限返回

获取所有字段为给定的标签

请求
查询参数
参数 类型 描述
projectKey

该项目的密钥; 此参数是可选

回复
  • 状态200
    对于给定的标签字段列表
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-screenable-tab#",
        "title": "List of Screenable Tab",
        "type": "array",
        "items": {
            "title": "Screenable Tab",
            "type": "object",
            "properties": {
                "id": {
                    "type": "integer"
                },
                "name": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态400
    如果屏幕或选项卡不存在,则返回
  • 状态401
    如果您没有权限返回

删除字段从给定的标签

回复
  • 状态201
    从标签成功移除场
  • 状态400
    如果屏幕或选项卡不存在,则返回
  • 状态401
    如果您没有权限返回

移动定标签上现场

请求
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/move-field#",
    "title": "Move Field",
    "type": "object",
    "properties": {
        "after": {
            "type": "string",
            "format": "uri"
        },
        "position": {
            "type": "string",
            "enum": [
                "Earlier",
                "Later",
                "First",
                "Last"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态201
    成功移动标签
  • 状态400
    如果屏幕或标签不存在返回。 或移动cooridinates无效。
  • 状态401
    如果您没有权限返回

移动标签的位置

回复
  • 状态201
    成功移动标签
  • 状态400
    如果屏幕或选项卡不存在,则返回
  • 状态401
    如果您没有权限返回

添加字段或自定义字段的默认选项卡

回复
  • 状态201
    成功添加字段的默认屏幕/默认选项卡
  • 状态400
    如果屏幕,选项卡或字段不存在或现场已经存在一个选择的选项卡上返回
  • 状态401
    如果您没有管理员权限返回

API / 2 /搜索隐藏的所有方法

资源,搜索。

进行利用JQL搜索。

请求
{
    "jql": "project = HSP",
    "startAt": 0,
    "maxResults": 15,
    "fields": [
        "summary",
        "status",
        "assignee"
    ]
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/search-request#",
    "title": "Search Request",
    "type": "object",
    "properties": {
        "jql": {
            "type": "string"
        },
        "startAt": {
            "type": "integer"
        },
        "maxResults": {
            "type": "integer"
        },
        "fields": {
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "validateQuery": {
            "type": "boolean"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    返回搜索结果的JSON表示。
    {
        "expand": "names,schema",
        "startAt": 0,
        "maxResults": 50,
        "total": 1,
        "issues": [
            {
                "expand": "",
                "id": "10001",
                "self": "http://www.example.com/jira/rest/api/2/issue/10001",
                "key": "HSP-1"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/search-results#",
        "title": "Search Results",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "startAt": {
                "type": "integer"
            },
            "maxResults": {
                "type": "integer"
            },
            "total": {
                "type": "integer"
            },
            "issues": {
                "type": "array",
                "items": {
                    "title": "Issue",
                    "type": "object",
                    "properties": {
                        "expand": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "key": {
                            "type": "string"
                        },
                        "fields": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {}
                            },
                            "additionalProperties": false
                        },
                        "renderedFields": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {}
                            },
                            "additionalProperties": false
                        },
                        "properties": {
                            "title": "Properties",
                            "type": "object",
                            "properties": {
                                "properties": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "additionalProperties": false
                        },
                        "names": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "schema": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "$ref": "#/definitions/json-type"
                                }
                            },
                            "additionalProperties": false
                        },
                        "transitions": {
                            "type": "array",
                            "items": {
                                "title": "Transition",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "to": {
                                        "title": "Status",
                                        "type": "object",
                                        "properties": {
                                            "self": {
                                                "type": "string"
                                            },
                                            "statusColor": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "iconUrl": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "statusCategory": {
                                                "title": "Status Category",
                                                "type": "object",
                                                "properties": {
                                                    "self": {
                                                        "type": "string"
                                                    },
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "key": {
                                                        "type": "string"
                                                    },
                                                    "colorName": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        },
                                        "additionalProperties": false
                                    },
                                    "fields": {
                                        "type": "object",
                                        "patternProperties": {
                                            ".+": {
                                                "$ref": "#/definitions/field-meta"
                                            }
                                        },
                                        "additionalProperties": false
                                    },
                                    "expand": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "operations": {
                            "title": "Opsbar",
                            "type": "object",
                            "properties": {
                                "linkGroups": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/definitions/link-group"
                                    }
                                }
                            },
                            "additionalProperties": false
                        },
                        "editmeta": {
                            "title": "Edit Meta",
                            "type": "object",
                            "properties": {
                                "fields": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "$ref": "#/definitions/field-meta"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "additionalProperties": false
                        },
                        "changelog": {
                            "title": "Changelog",
                            "type": "object",
                            "properties": {
                                "startAt": {
                                    "type": "integer"
                                },
                                "maxResults": {
                                    "type": "integer"
                                },
                                "total": {
                                    "type": "integer"
                                },
                                "histories": {
                                    "type": "array",
                                    "items": {
                                        "title": "Change History",
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "string"
                                            },
                                            "author": {
                                                "title": "User",
                                                "type": "object",
                                                "properties": {
                                                    "self": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "key": {
                                                        "type": "string"
                                                    },
                                                    "emailAddress": {
                                                        "type": "string"
                                                    },
                                                    "avatarUrls": {
                                                        "type": "object",
                                                        "patternProperties": {
                                                            ".+": {
                                                                "type": "string"
                                                            }
                                                        },
                                                        "additionalProperties": false
                                                    },
                                                    "displayName": {
                                                        "type": "string"
                                                    },
                                                    "active": {
                                                        "type": "boolean"
                                                    },
                                                    "timeZone": {
                                                        "type": "string"
                                                    }
                                                },
                                                "additionalProperties": false,
                                                "required": [
                                                    "active"
                                                ]
                                            },
                                            "created": {
                                                "type": "string"
                                            },
                                            "items": {
                                                "type": "array",
                                                "items": {
                                                    "title": "Change Item",
                                                    "type": "object",
                                                    "properties": {
                                                        "field": {
                                                            "type": "string"
                                                        },
                                                        "fieldtype": {
                                                            "type": "string"
                                                        },
                                                        "from": {
                                                            "type": "string"
                                                        },
                                                        "fromString": {
                                                            "type": "string"
                                                        },
                                                        "to": {
                                                            "type": "string"
                                                        },
                                                        "toString": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "additionalProperties": false
                                                }
                                            },
                                            "historyMetadata": {
                                                "title": "History Metadata",
                                                "type": "object",
                                                "properties": {
                                                    "type": {
                                                        "type": "string"
                                                    },
                                                    "description": {
                                                        "type": "string"
                                                    },
                                                    "descriptionKey": {
                                                        "type": "string"
                                                    },
                                                    "activityDescription": {
                                                        "type": "string"
                                                    },
                                                    "activityDescriptionKey": {
                                                        "type": "string"
                                                    },
                                                    "emailDescription": {
                                                        "type": "string"
                                                    },
                                                    "emailDescriptionKey": {
                                                        "type": "string"
                                                    },
                                                    "actor": {
                                                        "$ref": "#/definitions/history-metadata-participant"
                                                    },
                                                    "generator": {
                                                        "$ref": "#/definitions/history-metadata-participant"
                                                    },
                                                    "cause": {
                                                        "$ref": "#/definitions/history-metadata-participant"
                                                    },
                                                    "extraData": {
                                                        "type": "object",
                                                        "patternProperties": {
                                                            ".+": {
                                                                "type": "string"
                                                            }
                                                        },
                                                        "additionalProperties": false
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                }
                            },
                            "additionalProperties": false
                        },
                        "versionedRepresentations": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {}
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "additionalProperties": false
                        },
                        "fieldsToInclude": {
                            "title": "Included Fields",
                            "type": "object"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "warningMessages": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "names": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "schema": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "$ref": "#/definitions/json-type"
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "field-meta": {
                "title": "Field Meta",
                "type": "object",
                "properties": {
                    "required": {
                        "type": "boolean"
                    },
                    "schema": {
                        "$ref": "#/definitions/json-type"
                    },
                    "name": {
                        "type": "string"
                    },
                    "autoCompleteUrl": {
                        "type": "string"
                    },
                    "hasDefaultValue": {
                        "type": "boolean"
                    },
                    "operations": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "allowedValues": {
                        "type": "array",
                        "items": {}
                    }
                },
                "additionalProperties": false,
                "required": [
                    "required"
                ]
            },
            "history-metadata-participant": {
                "title": "History Metadata Participant",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "displayNameKey": {
                        "type": "string"
                    },
                    "type": {
                        "type": "string"
                    },
                    "avatarUrl": {
                        "type": "string"
                    },
                    "url": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "json-type": {
                "title": "Json Type",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string"
                    },
                    "items": {
                        "type": "string"
                    },
                    "system": {
                        "type": "string"
                    },
                    "custom": {
                        "type": "string"
                    },
                    "customId": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false
            },
            "link-group": {
                "title": "Link Group",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "styleClass": {
                        "type": "string"
                    },
                    "header": {
                        "$ref": "#/definitions/simple-link"
                    },
                    "weight": {
                        "type": "integer"
                    },
                    "links": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/simple-link"
                        }
                    },
                    "groups": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/link-group"
                        }
                    }
                },
                "additionalProperties": false
            },
            "simple-link": {
                "title": "Simple Link",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "styleClass": {
                        "type": "string"
                    },
                    "iconClass": {
                        "type": "string"
                    },
                    "label": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "href": {
                        "type": "string"
                    },
                    "weight": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果有一个与JQL查询问题返回。

搜索使用JQL问题。

排序 jql 参数是一个完整的 JQL 表达,并包括一个 ORDER BY 条款。

fields 参数(可多次指定)给出了一个逗号分隔的字段列表中应对包括。 这可以用于检索字段的子集。 一个特定的领域可以通过负前缀就被排除在外。

默认情况下,唯一的通航( *navigable )字段在此搜索资源返回。 注意:默认为在Get-问题的资源不同-默认情况下有所有字段( *all )。

  • *all - 包括所有领域
  • *navigable - 包括刚刚通航领域
  • summary,comment - 仅包含了总结和评论
  • -description -包括除了描述通航字段(默认为 *navigable 搜索)
  • *all,-comment - 除了包含所有评论

获得与POST: 如果JQL查询过大,编码为查询参数则应该张贴到此资源。

在搜索结果中扩大的问题: 它可以扩大通过直接指定在这个资源传递的参数扩展扩展返回的问题。

例如,为了扩大“更新日志”中关于搜索结果的所有问题,这是neccesary指定“更新日志”,以扩大的一个值。

请求
查询参数
参数 类型 描述
jql

一个JQL查询字符串

startAt INT

第一个问题的索引返回(从0开始)

maxResults INT

问题的最大数目返回(默认为50)。 的最大允许值由JIRA属性决定'jira.search.views.default.max'。 如果指定的值比这个数字高,你的搜索结果将被截断。

validateQuery 布尔

默认值:

是否验证JQL查询

fields

字段列表返回每个问题。 默认情况下,所有通航领域被返回。

expand

用逗号分隔的参数列表扩大。

回复
  • 状态200 - 应用程序/ JSON
    返回搜索结果的JSON表示。
    {
        "expand": "names,schema",
        "startAt": 0,
        "maxResults": 50,
        "total": 1,
        "issues": [
            {
                "expand": "",
                "id": "10001",
                "self": "http://www.example.com/jira/rest/api/2/issue/10001",
                "key": "HSP-1"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/search-results#",
        "title": "Search Results",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "startAt": {
                "type": "integer"
            },
            "maxResults": {
                "type": "integer"
            },
            "total": {
                "type": "integer"
            },
            "issues": {
                "type": "array",
                "items": {
                    "title": "Issue",
                    "type": "object",
                    "properties": {
                        "expand": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "key": {
                            "type": "string"
                        },
                        "fields": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {}
                            },
                            "additionalProperties": false
                        },
                        "renderedFields": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {}
                            },
                            "additionalProperties": false
                        },
                        "properties": {
                            "title": "Properties",
                            "type": "object",
                            "properties": {
                                "properties": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "type": "string"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "additionalProperties": false
                        },
                        "names": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "type": "string"
                                }
                            },
                            "additionalProperties": false
                        },
                        "schema": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "$ref": "#/definitions/json-type"
                                }
                            },
                            "additionalProperties": false
                        },
                        "transitions": {
                            "type": "array",
                            "items": {
                                "title": "Transition",
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "type": "string"
                                    },
                                    "name": {
                                        "type": "string"
                                    },
                                    "to": {
                                        "title": "Status",
                                        "type": "object",
                                        "properties": {
                                            "self": {
                                                "type": "string"
                                            },
                                            "statusColor": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "iconUrl": {
                                                "type": "string"
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "id": {
                                                "type": "string"
                                            },
                                            "statusCategory": {
                                                "title": "Status Category",
                                                "type": "object",
                                                "properties": {
                                                    "self": {
                                                        "type": "string"
                                                    },
                                                    "id": {
                                                        "type": "integer"
                                                    },
                                                    "key": {
                                                        "type": "string"
                                                    },
                                                    "colorName": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        },
                                        "additionalProperties": false
                                    },
                                    "fields": {
                                        "type": "object",
                                        "patternProperties": {
                                            ".+": {
                                                "$ref": "#/definitions/field-meta"
                                            }
                                        },
                                        "additionalProperties": false
                                    },
                                    "expand": {
                                        "type": "string"
                                    }
                                },
                                "additionalProperties": false
                            }
                        },
                        "operations": {
                            "title": "Opsbar",
                            "type": "object",
                            "properties": {
                                "linkGroups": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/definitions/link-group"
                                    }
                                }
                            },
                            "additionalProperties": false
                        },
                        "editmeta": {
                            "title": "Edit Meta",
                            "type": "object",
                            "properties": {
                                "fields": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {
                                            "$ref": "#/definitions/field-meta"
                                        }
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "additionalProperties": false
                        },
                        "changelog": {
                            "title": "Changelog",
                            "type": "object",
                            "properties": {
                                "startAt": {
                                    "type": "integer"
                                },
                                "maxResults": {
                                    "type": "integer"
                                },
                                "total": {
                                    "type": "integer"
                                },
                                "histories": {
                                    "type": "array",
                                    "items": {
                                        "title": "Change History",
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "string"
                                            },
                                            "author": {
                                                "title": "User",
                                                "type": "object",
                                                "properties": {
                                                    "self": {
                                                        "type": "string"
                                                    },
                                                    "name": {
                                                        "type": "string"
                                                    },
                                                    "key": {
                                                        "type": "string"
                                                    },
                                                    "emailAddress": {
                                                        "type": "string"
                                                    },
                                                    "avatarUrls": {
                                                        "type": "object",
                                                        "patternProperties": {
                                                            ".+": {
                                                                "type": "string"
                                                            }
                                                        },
                                                        "additionalProperties": false
                                                    },
                                                    "displayName": {
                                                        "type": "string"
                                                    },
                                                    "active": {
                                                        "type": "boolean"
                                                    },
                                                    "timeZone": {
                                                        "type": "string"
                                                    }
                                                },
                                                "additionalProperties": false,
                                                "required": [
                                                    "active"
                                                ]
                                            },
                                            "created": {
                                                "type": "string"
                                            },
                                            "items": {
                                                "type": "array",
                                                "items": {
                                                    "title": "Change Item",
                                                    "type": "object",
                                                    "properties": {
                                                        "field": {
                                                            "type": "string"
                                                        },
                                                        "fieldtype": {
                                                            "type": "string"
                                                        },
                                                        "from": {
                                                            "type": "string"
                                                        },
                                                        "fromString": {
                                                            "type": "string"
                                                        },
                                                        "to": {
                                                            "type": "string"
                                                        },
                                                        "toString": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "additionalProperties": false
                                                }
                                            },
                                            "historyMetadata": {
                                                "title": "History Metadata",
                                                "type": "object",
                                                "properties": {
                                                    "type": {
                                                        "type": "string"
                                                    },
                                                    "description": {
                                                        "type": "string"
                                                    },
                                                    "descriptionKey": {
                                                        "type": "string"
                                                    },
                                                    "activityDescription": {
                                                        "type": "string"
                                                    },
                                                    "activityDescriptionKey": {
                                                        "type": "string"
                                                    },
                                                    "emailDescription": {
                                                        "type": "string"
                                                    },
                                                    "emailDescriptionKey": {
                                                        "type": "string"
                                                    },
                                                    "actor": {
                                                        "$ref": "#/definitions/history-metadata-participant"
                                                    },
                                                    "generator": {
                                                        "$ref": "#/definitions/history-metadata-participant"
                                                    },
                                                    "cause": {
                                                        "$ref": "#/definitions/history-metadata-participant"
                                                    },
                                                    "extraData": {
                                                        "type": "object",
                                                        "patternProperties": {
                                                            ".+": {
                                                                "type": "string"
                                                            }
                                                        },
                                                        "additionalProperties": false
                                                    }
                                                },
                                                "additionalProperties": false
                                            }
                                        },
                                        "additionalProperties": false
                                    }
                                }
                            },
                            "additionalProperties": false
                        },
                        "versionedRepresentations": {
                            "type": "object",
                            "patternProperties": {
                                ".+": {
                                    "type": "object",
                                    "patternProperties": {
                                        ".+": {}
                                    },
                                    "additionalProperties": false
                                }
                            },
                            "additionalProperties": false
                        },
                        "fieldsToInclude": {
                            "title": "Included Fields",
                            "type": "object"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "warningMessages": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "names": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "schema": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "$ref": "#/definitions/json-type"
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "field-meta": {
                "title": "Field Meta",
                "type": "object",
                "properties": {
                    "required": {
                        "type": "boolean"
                    },
                    "schema": {
                        "$ref": "#/definitions/json-type"
                    },
                    "name": {
                        "type": "string"
                    },
                    "autoCompleteUrl": {
                        "type": "string"
                    },
                    "hasDefaultValue": {
                        "type": "boolean"
                    },
                    "operations": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "allowedValues": {
                        "type": "array",
                        "items": {}
                    }
                },
                "additionalProperties": false,
                "required": [
                    "required"
                ]
            },
            "history-metadata-participant": {
                "title": "History Metadata Participant",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "displayNameKey": {
                        "type": "string"
                    },
                    "type": {
                        "type": "string"
                    },
                    "avatarUrl": {
                        "type": "string"
                    },
                    "url": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "json-type": {
                "title": "Json Type",
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string"
                    },
                    "items": {
                        "type": "string"
                    },
                    "system": {
                        "type": "string"
                    },
                    "custom": {
                        "type": "string"
                    },
                    "customId": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false
            },
            "link-group": {
                "title": "Link Group",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "styleClass": {
                        "type": "string"
                    },
                    "header": {
                        "$ref": "#/definitions/simple-link"
                    },
                    "weight": {
                        "type": "integer"
                    },
                    "links": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/simple-link"
                        }
                    },
                    "groups": {
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/link-group"
                        }
                    }
                },
                "additionalProperties": false
            },
            "simple-link": {
                "title": "Simple Link",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "styleClass": {
                        "type": "string"
                    },
                    "iconClass": {
                        "type": "string"
                    },
                    "label": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "href": {
                        "type": "string"
                    },
                    "weight": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态400
    如果有一个与JQL查询问题返回。

API / 2 / securitylevel中隐藏的所有方法

返回具有给定id的安全级别的完整表示。

回复
  • 状态200 - 应用程序/ JSON
    如果问题的类型存在且由主叫用户可见返回。
    {
        "self": "http://www.example.com/jira/rest/api/2/securitylevel/10021",
        "id": "10021",
        "description": "Only the reporter and internal staff can see this issue.",
        "name": "Reporter Only"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/security-level#",
        "title": "Security Level",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "id": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "name": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果返回的问题类型不存在,或者不是给主叫用户可见。

API / 2 / serverInfo 隐藏所有方法

返回当前JIRA服务器的一般信息。

请求
查询参数
参数 类型 描述
doHealthCheck 布尔
回复
  • 状态200 - 应用程序/ JSON
    返回JSON格式的服务器信息的完整表示
    {
        "baseUrl": "http://localhost:8080/jira",
        "version": "5.0-SNAPSHOT",
        "versionNumbers": [
            5,
            0,
            0
        ],
        "buildNumber": 582,
        "buildDate": "2016-09-06T09:48:11.680+0000",
        "serverTime": "2016-09-06T09:48:11.680+0000",
        "scmInfo": "1f51473f5c7b75c1a69a0090f4832cdc5053702a",
        "buildPartnerName": "Example Partner Co.",
        "serverTitle": "My Shiny New JIRA Server"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/server-info#",
        "title": "Server Info",
        "type": "object",
        "properties": {
            "baseUrl": {
                "type": "string"
            },
            "version": {
                "type": "string"
            },
            "versionNumbers": {
                "type": "array",
                "items": {
                    "type": "integer"
                }
            },
            "deploymentType": {
                "type": "string"
            },
            "buildNumber": {
                "type": "integer"
            },
            "buildDate": {
                "type": "string"
            },
            "serverTime": {
                "type": "string"
            },
            "scmInfo": {
                "type": "string"
            },
            "buildPartnerName": {
                "type": "string"
            },
            "serverTitle": {
                "type": "string"
            },
            "healthChecks": {
                "type": "array",
                "items": {
                    "title": "Health Check Result",
                    "type": "object",
                    "properties": {
                        "name": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "passed": {
                            "type": "boolean"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }

API / 2 /设置隐藏所有方法

为改变JIRA系统设置REST资源

设置配置为这个JIRA实例的基本URL。

请求
http://jira.atlassian.com/
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/string#",
    "title": "String",
    "type": "string"
}

返回问题导航系统默认列。 管理员权限是必需的。

回复
  • 状态200 - 应用程序/ JSON
    返回列的列表进行配置给定用户
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-column-item#",
        "title": "List of Column Item",
        "type": "array",
        "items": {
            "title": "Column Item",
            "type": "object",
            "properties": {
                "label": {
                    "type": "string"
                },
                "value": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态500
    返回如果检索列配置发生了错误。
  • 状态403
    如果用户没有管理权限返回

设置问题导航系统默认列。 管理员权限是必需的。

请求
回复
  • 状态200
    当列保存成功返回
  • 状态500
    返回如果检索列配置发生了错误。

API / 2 /状态隐藏所有方法

返回所有状态的列表

回复
  • 状态200 - 应用程序/ JSON
    以JSON格式返回所有的JIRA问题的状态,是对用户可见的列表。
    [
        {
            "self": "http://localhost:8090/jira/rest/api/2.0/status/10000",
            "description": "The issue is currently being worked on.",
            "iconUrl": "http://localhost:8090/jira/images/icons/progress.gif",
            "name": "In Progress",
            "id": "10000",
            "statusCategory": {
                "self": "http://localhost:8090/jira/rest/api/2.0/statuscategory/1",
                "id": 1,
                "key": "in-flight",
                "colorName": "yellow",
                "name": "In Progress"
            }
        },
        {
            "self": "http://localhost:8090/jira/rest/api/2.0/status/5",
            "description": "The issue is closed.",
            "iconUrl": "http://localhost:8090/jira/images/icons/closed.gif",
            "name": "Closed",
            "id": "5",
            "statusCategory": {
                "self": "http://localhost:8090/jira/rest/api/2.0/statuscategory/9",
                "id": 9,
                "key": "completed",
                "colorName": "green"
            }
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-status#",
        "title": "List of Status",
        "type": "array",
        "items": {
            "title": "Status",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string"
                },
                "statusColor": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "iconUrl": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "id": {
                    "type": "string"
                },
                "statusCategory": {
                    "title": "Status Category",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "id": {
                            "type": "integer"
                        },
                        "key": {
                            "type": "string"
                        },
                        "colorName": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "additionalProperties": false
        }
    }
  • 状态404
    返回如果请求的问题状态没有找到,或者用户没有权限查看。

返回具有给定id或名称状态的完整表示。

回复
  • 状态200 - 应用程序/ JSON
    返回的JSON格式的JIRA问题状态的完整表示。
    {
        "self": "http://localhost:8090/jira/rest/api/2.0/status/10000",
        "description": "The issue is currently being worked on.",
        "iconUrl": "http://localhost:8090/jira/images/icons/progress.gif",
        "name": "In Progress",
        "id": "10000",
        "statusCategory": {
            "self": "http://localhost:8090/jira/rest/api/2.0/statuscategory/1",
            "id": 1,
            "key": "in-flight",
            "colorName": "yellow",
            "name": "In Progress"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/status#",
        "title": "Status",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "statusColor": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "iconUrl": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "id": {
                "type": "string"
            },
            "statusCategory": {
                "title": "Status Category",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string"
                    },
                    "id": {
                        "type": "integer"
                    },
                    "key": {
                        "type": "string"
                    },
                    "colorName": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态404
    返回如果请求的问题状态没有找到,或者用户没有权限查看。

API / 2 / statuscategory 隐藏所有方法

返回所有状态类别列表

回复
  • 状态200 - 应用程序/ JSON
    以JSON格式返回所有的JIRA问题状态类别,是对用户可见的列表。
    [
        {
            "self": "http://localhost:8090/jira/rest/api/2.0/statuscategory/1",
            "id": 1,
            "key": "in-flight",
            "colorName": "yellow",
            "name": "In Progress"
        },
        {
            "self": "http://localhost:8090/jira/rest/api/2.0/statuscategory/9",
            "id": 9,
            "key": "completed",
            "colorName": "green"
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-status-category#",
        "title": "List of Status Category",
        "type": "array",
        "items": {
            "title": "Status Category",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string"
                },
                "id": {
                    "type": "integer"
                },
                "key": {
                    "type": "string"
                },
                "colorName": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态404
    返回如果没有状态类别被发现,或者用户没有权限查看。

返回StatusCategory具有给定id或密钥完整表示

回复
  • 状态200 - 应用程序/ JSON
    返回JSON格式的JIRA问题状态类别的完整表示。
    {
        "self": "http://localhost:8090/jira/rest/api/2.0/statuscategory/1",
        "id": 1,
        "key": "in-flight",
        "colorName": "yellow",
        "name": "In Progress"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/status-category#",
        "title": "Status Category",
        "type": "object",
        "properties": {
            "self": {
                "type": "string"
            },
            "id": {
                "type": "integer"
            },
            "key": {
                "type": "string"
            },
            "colorName": {
                "type": "string"
            },
            "name": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态404
    返回如果未找到所请求的问题状态类,或者用户没有权限查看。

API / 2 / universal_avatar 隐藏所有方法

回复
  • 状态 - 应用程序/ JSON
请求
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
    "title": "Avatar Cropping",
    "type": "object",
    "properties": {
        "cropperWidth": {
            "type": "integer"
        },
        "cropperOffsetX": {
            "type": "integer"
        },
        "cropperOffsetY": {
            "type": "integer"
        },
        "url": {
            "type": "string"
        },
        "needsCropping": {
            "type": "boolean"
        }
    },
    "additionalProperties": false,
    "required": [
        "cropperWidth",
        "cropperOffsetX",
        "cropperOffsetY",
        "needsCropping"
    ]
}
回复
  • 状态 - 应用程序/ JSON

删除头像

回复
  • 状态 - 应用程序/ JSON

创建临时头像

请求
查询参数
参数 类型 描述
filename

文件的名称被上传

size

文件大小

回复
  • 状态 - 应用程序/ JSON
回复
  • 状态 - 为text / html

API / 2 /升级隐藏所有方法

用于执行和查询延迟升级REST资源。

运行任何挂起延迟升级任务。 需要管理员权限才能做到这一点。

回复
  • 状态 - 应用程序/ JSON

返回最后一个升级任务的结果。 返回{@link javax.ws.rs.core.Response#seeOther(java.net.URI中)}如果仍在运行。

回复
  • 状态200 - 应用程序/ JSON
    如果返回升级完成
    {
        "startTime": "2016-09-06T09:48:13.461+0000",
        "duration": 2001,
        "outcome": "SUCCESS",
        "message": ""
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/upgrade-result#",
        "title": "Upgrade Result",
        "type": "object",
        "properties": {
            "startTime": {
                "type": "string"
            },
            "duration": {
                "type": "integer"
            },
            "outcome": {
                "type": "string"
            },
            "message": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态303
    返回如果升级任务仍在运行。
  • 状态404
    如果没有事先升级任务存在返回。

API / 2 /用户隐藏所有方法

返回用户。 此资源不能被匿名访问。

请求
查询参数
参数 类型 描述
username

用户名

key

用户密钥

回复
  • 状态200 - 应用程序/ JSON
    返回JIRA用户JSON格式的完整表示。
    {
        "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
        "name": "fred",
        "emailAddress": "fred@example.com",
        "avatarUrls": {
            "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
            "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
            "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
            "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
        },
        "displayName": "Fred F. User",
        "active": true,
        "timeZone": "Australia/Sydney",
        "groups": {
            "size": 3,
            "items": [
                {
                    "name": "jira-user",
                    "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-user"
                },
                {
                    "name": "jira-admin",
                    "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-admin"
                },
                {
                    "name": "important",
                    "self": "http://www.example.com/jira/rest/api/2/group?groupname=important"
                }
            ]
        },
        "applicationRoles": {
            "size": 1,
            "items": []
        },
        "expand": "groups,applicationRoles"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/user#",
        "title": "User",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "key": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "emailAddress": {
                "type": "string"
            },
            "avatarUrls": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "displayName": {
                "type": "string"
            },
            "active": {
                "type": "boolean"
            },
            "timeZone": {
                "type": "string"
            },
            "locale": {
                "type": "string"
            },
            "groups": {
                "$ref": "#/definitions/simple-list-wrapper"
            },
            "applicationRoles": {
                "$ref": "#/definitions/simple-list-wrapper"
            },
            "expand": {
                "type": "string"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "active"
        ]
    }
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态404
    如果所请求的用户未找到返回。

创建用户。 默认情况下创建的用户不会收到电子邮件通知。 如果没有设置密码字段则密码将随机生成。

请求
{
    "name": "charlie",
    "password": "abracadabra",
    "emailAddress": "charlie@atlassian.com",
    "displayName": "Charlie of Atlassian",
    "applicationKeys": [
        "jira-core"
    ]
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/user-write#",
    "title": "User Write",
    "type": "object",
    "properties": {
        "key": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "password": {
            "type": "string"
        },
        "emailAddress": {
            "type": "string"
        },
        "displayName": {
            "type": "string"
        },
        "notification": {
            "type": "string"
        },
        "applicationKeys": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "additionalProperties": false
}
回复
  • 状态201
    如果用户创建返回。
    {
        "self": "http://www.example.com/jirahttp://www.example.com/jira/rest/api/2/user/charlie",
        "key": "charlie",
        "name": "charlie",
        "emailAddress": "charlie@atlassian.com",
        "displayName": "Charlie of Atlassian"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/user#",
        "title": "User",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "key": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "emailAddress": {
                "type": "string"
            },
            "avatarUrls": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "displayName": {
                "type": "string"
            },
            "active": {
                "type": "boolean"
            },
            "timeZone": {
                "type": "string"
            },
            "locale": {
                "type": "string"
            },
            "groups": {
                "$ref": "#/definitions/simple-list-wrapper"
            },
            "applicationRoles": {
                "$ref": "#/definitions/simple-list-wrapper"
            },
            "expand": {
                "type": "string"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "active"
        ]
    }
  • 状态400
    返回如果请求是无效的。
  • 状态401
    返回,如果用户不被认证。
  • 状态500
    如果用户不是因为其他错误创建返回。
  • 状态403
    返回如果调用者的用户没有权限来创建用户。

修改用户。 目前“价值”字段将覆盖现有的值。 字段跳过请求将不会被改变。

请求
查询参数
参数 类型 描述
username

用户名

key

用户密钥

{
    "name": "eddie",
    "emailAddress": "eddie@atlassian.com",
    "displayName": "Eddie of Atlassian"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/user-write#",
    "title": "User Write",
    "type": "object",
    "properties": {
        "key": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "password": {
            "type": "string"
        },
        "emailAddress": {
            "type": "string"
        },
        "displayName": {
            "type": "string"
        },
        "notification": {
            "type": "string"
        },
        "applicationKeys": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    如果用户存在,并且调用者有权编辑它返回。
    {
        "self": "http://www.example.com/jirahttp://www.example.com/jira/rest/api/2/user/charlie",
        "key": "charlie",
        "name": "charlie",
        "emailAddress": "charlie@atlassian.com",
        "displayName": "Charlie of Atlassian"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/user#",
        "title": "User",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "key": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "emailAddress": {
                "type": "string"
            },
            "avatarUrls": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "displayName": {
                "type": "string"
            },
            "active": {
                "type": "boolean"
            },
            "timeZone": {
                "type": "string"
            },
            "locale": {
                "type": "string"
            },
            "groups": {
                "$ref": "#/definitions/simple-list-wrapper"
            },
            "applicationRoles": {
                "$ref": "#/definitions/simple-list-wrapper"
            },
            "expand": {
                "type": "string"
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false,
        "required": [
            "active"
        ]
    }
  • 状态400
    返回如果请求是无效的。
  • 状态401
    返回,如果用户不被认证。
  • 状态403
    返回如果调用方用户没有权限编辑的用户。
  • 状态404
    返回如果调用者确实有权限编辑用户,但该用户不存在。

删除用户。

请求
查询参数
参数 类型 描述
username

用户名

key

用户密钥

回复
  • 状态400
    返回如果请求是无效或发生了一些其他的服务器错误。
  • 状态401
    返回,如果用户不被认证。
  • 状态204
    返回如果用户被成功删除。
  • 状态403
    返回如果调用者没有权限删除用户。
  • 状态404
    返回如果调用者有权删除用户,但该用户不存在。

将用户添加到给定的应用。 管理员权限将被要求执行该操作。

请求
查询参数
参数 类型 描述
username

用户名

applicationKey

应用程序键

回复
  • 状态200
    如果用户存在返回,调用者已成功添加到应用程序的权限添加用户到应用程序和用户。
  • 状态400
    返回如果请求是无效的。
  • 状态401
    返回,如果用户不被认证。
  • 状态403
    返回如果调用者的用户没有权限添加用户到应用程序。

取下给定应用程序的用户。 管理员权限将被要求执行该操作。

请求
查询参数
参数 类型 描述
username

用户名

applicationKey

应用程序键

回复
  • 状态400
    返回如果请求是无效的。
  • 状态401
    返回,如果用户不被认证。
  • 状态204
    如果用户存在返回,调用者有权从应用程序中删除用户和用户已成功从应用程序中删除。
  • 状态403
    返回如果调用者的用户没有权限从应用程序中删除用户。

返回匹配搜索字符串和可分配为所有给定项目的问题是用户的列表。 此资源不能被匿名访问。

请求
查询参数
参数 类型 描述
username

用户名

projectKeys

项目的关键,我们正在寻找分配为用户,用逗号分隔

startAt INT

第一用户的索引返回(从0开始)

maxResults INT

用户的最大数量返回(默认为50)。 最大允许值为1000。如果指定的值比这个数字更高,搜索结果将被截断。

回复
  • 状态200 - 应用程序/ JSON
    返回JIRA用户JSON格式的完整表示。
    [
        {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        {
            "self": "http://www.example.com/jira/rest/api/2/user?username=andrew",
            "name": "andrew",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=andrew",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=andrew",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=andrew",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=andrew"
            },
            "displayName": "Andrew Anderson",
            "active": false
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-user#",
        "title": "List of User",
        "type": "array",
        "items": {
            "title": "User",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "expand": {
                    "type": "string"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        }
    }
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态404
    如果所请求的用户未找到返回。

返回与搜索字符串匹配用户的列表。 此资源不能被匿名访问。 请注意,该资源应该问题键时分配的用户的列表是用于编辑检索调用。 对于只创建应提供一个项目的关键。 如果它被称为与编辑项目的关键分配的用户列表可能不正确。

请求
查询参数
参数 类型 描述
username

用户名

project

该项目的关键,我们发现可分配的用户为

issueKey

对这一问题的关键问题正在编辑,我们需要找到分配的用户提供。

startAt INT

第一用户的索引返回(从0开始)

maxResults INT

用户的最大数量返回(默认为50)。 最大允许值为1000。如果指定的值比这个数字更高,搜索结果将被截断。

actionDescriptorId INT
回复
  • 状态200 - 应用程序/ JSON
    返回JIRA用户JSON格式的完整表示。
    {
        "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
        "name": "fred",
        "emailAddress": "fred@example.com",
        "avatarUrls": {
            "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
            "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
            "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
            "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
        },
        "displayName": "Fred F. User",
        "active": true,
        "timeZone": "Australia/Sydney",
        "groups": {
            "size": 3,
            "items": [
                {
                    "name": "jira-user",
                    "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-user"
                },
                {
                    "name": "jira-admin",
                    "self": "http://www.example.com/jira/rest/api/2/group?groupname=jira-admin"
                },
                {
                    "name": "important",
                    "self": "http://www.example.com/jira/rest/api/2/group?groupname=important"
                }
            ]
        },
        "applicationRoles": {
            "size": 1,
            "items": []
        },
        "expand": "groups,applicationRoles"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-user#",
        "title": "List of User",
        "type": "array",
        "items": {
            "title": "User",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "expand": {
                    "type": "string"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        }
    }
  • 状态400
    如果没有提供项目或问题键返回
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态404
    如果所请求的用户未找到返回。

临时化身转换成一个真正的头像

请求
查询参数
参数 类型 描述
username

用户名

{
    "cropperWidth": 120,
    "cropperOffsetX": 50,
    "cropperOffsetY": 50,
    "needsCropping": false
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
    "title": "Avatar Cropping",
    "type": "object",
    "properties": {
        "cropperWidth": {
            "type": "integer"
        },
        "cropperOffsetX": {
            "type": "integer"
        },
        "cropperOffsetY": {
            "type": "integer"
        },
        "url": {
            "type": "string"
        },
        "needsCropping": {
            "type": "boolean"
        }
    },
    "additionalProperties": false,
    "required": [
        "cropperWidth",
        "cropperOffsetX",
        "cropperOffsetY",
        "needsCropping"
    ]
}
回复
  • 状态201 - 应用程序/ JSON
    返回创建头像
    {
        "id": "1000",
        "owner": "fred",
        "isSystemAvatar": true,
        "isSelected": false,
        "isDeletable": false,
        "urls": {
            "16x16": "http://localhost:8090/jira/secure/useravatar?size=xsmall&avatarId=10040",
            "24x24": "http://localhost:8090/jira/secure/useravatar?size=small&avatarId=10040",
            "32x32": "http://localhost:8090/jira/secure/useravatar?size=medium&avatarId=10040",
            "48x48": "http://localhost:8090/jira/secure/useravatar?avatarId=10040"
        },
        "selected": false
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/avatar#",
        "title": "Avatar",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "owner": {
                "type": "string"
            },
            "isSystemAvatar": {
                "type": "boolean"
            },
            "isSelected": {
                "type": "boolean"
            },
            "isDeletable": {
                "type": "boolean"
            },
            "urls": {
                "type": "object",
                "patternProperties": {
                    "\\d\\dx\\d\\d": {
                        "type": "string",
                        "format": "uri"
                    }
                },
                "additionalProperties": false
            },
            "selected": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "isSystemAvatar",
            "isSelected",
            "isDeletable",
            "selected"
        ]
    }
  • 状态400
    返回如果裁剪坐标无效
  • 状态500
    返回如果在临时化身转换为真正的化身出现错误
  • 状态403
    返回如果当前身份验证的用户没有权限来接头像
  • 状态404
    返回如果当前身份验证的用户不具有编辑项目权限。
请求
查询参数
参数 类型 描述
username
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/avatar#",
    "title": "Avatar",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "owner": {
            "type": "string"
        },
        "isSystemAvatar": {
            "type": "boolean"
        },
        "isSelected": {
            "type": "boolean"
        },
        "isDeletable": {
            "type": "boolean"
        },
        "urls": {
            "type": "object",
            "patternProperties": {
                "\\d\\dx\\d\\d": {
                    "type": "string",
                    "format": "uri"
                }
            },
            "additionalProperties": false
        },
        "selected": {
            "type": "boolean"
        }
    },
    "additionalProperties": false,
    "required": [
        "isSystemAvatar",
        "isSelected",
        "isDeletable",
        "selected"
    ]
}
回复
  • 状态 - 应用程序/ JSON

删除头像

请求
查询参数
参数 类型 描述
username

用户名

回复
  • 状态204 - 应用程序/ JSON
    如果返回的头像被成功删除。
  • 状态403
    返回如果当前身份验证的用户没有权限删除头像。
  • 状态404
    如果分身不存在,或当前身份验证的用户没有权限删除它返回。

创建临时的头像。 创建一个临时的头像是在上传新的头像为用户提供3个步骤的一部分:上传,裁剪,确认。

下面的实施例示出了使用卷曲这三个步骤。 饼干(会话)需要请求之间要保留,因此,使用-b和-c的。 在步骤2中创建的ID需要传递到步骤3(可以简单地传递步骤2的作为步骤3的请求的整个响应)。

 卷曲-c cookiejar.txt -X POST -u管理:管理员-H“X-Atlassian的令牌:无检查”\
   -H“内容类型:图像/ PNG”--data二进制@ mynewavatar.png \
   的“http://本地主机:8090 / JIRA / REST / API / 2 /用户/化身/临时用户名=管理员及文件名= mynewavatar.png”

 卷曲-b cookiejar.txt -X POST -u管理:管理员-H“X-Atlassian的令牌:无检查”\
   -H“内容类型:应用程序/ JSON”--data“{”cropperWidth“:”65“,”cropperOffsetX“:”10“,”cropperOffsetY“:”16“}'\
   -o tmpid.json \
   HTTP://本地主机:8090 / JIRA / REST / API / 2 /用户/用户名头像管理员=

 卷曲-b cookiejar.txt -X PUT -u管理:管理员-H“X-Atlassian的令牌:无检查”\
   -H“内容类型:应用程序/ JSON”--data二进制@ tmpid.json \
   HTTP://本地主机:8090 / JIRA / REST / API / 2 /用户/用户名头像管理员=
 

请求
查询参数
参数 类型 描述
username

用户名

filename

文件的名称被上传

size

文件大小

回复
  • 状态201 - 应用程序/ JSON
    临时头像裁剪说明
    {
        "cropperWidth": 120,
        "cropperOffsetX": 50,
        "cropperOffsetY": 50,
        "url": "http://example.com/jira/secure/temporaryavatar?cropped=true",
        "needsCropping": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
        "title": "Avatar Cropping",
        "type": "object",
        "properties": {
            "cropperWidth": {
                "type": "integer"
            },
            "cropperOffsetX": {
                "type": "integer"
            },
            "cropperOffsetY": {
                "type": "integer"
            },
            "url": {
                "type": "string"
            },
            "needsCropping": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "cropperWidth",
            "cropperOffsetX",
            "cropperOffsetY",
            "needsCropping"
        ]
    }
  • 状态500
    返回如果在临时化身转换为真正的化身出现错误
  • 状态403
    如果该请求不conain有效XSRF令牌返回
  • 状态404
    返回如果当前身份验证的用户不具有编辑项目权限。

创建使用多临时头像。 响应被发送回存储在一个textarea JSON。 这是因为客户端使用远程iframing使用多提交化身。 因此,我们必须从回该客户端从解析JSON给他们一个有效的HTML页面。

创建一个临时的头像是在上传新的头像为用户提供3个步骤的一部分:上传,裁剪,确认。 此端点允许您使用多部分上传的,而不是直接发送图像作为请求体。

你*必须*使用“阿凡达”作为上传参数的名称:

 卷曲-c cookiejar.txt -X POST -u管理:管理员-H“X-Atlassian的令牌:无检查”\
   -F“avatar=@mynewavatar.png;类型=图像/ PNG”\
   的“http://本地主机:8090 / JIRA / REST / API / 2 /用户/化身/临时用户名=管理员”
 

请求
查询参数
参数 类型 描述
username

用户名

回复
  • 状态201 - text / html的
    临时头像裁剪指令内嵌在HTML页面。 错误信息也将在页面中内嵌。
    {
        "cropperWidth": 120,
        "cropperOffsetX": 50,
        "cropperOffsetY": 50,
        "url": "http://example.com/jira/secure/temporaryavatar?cropped=true",
        "needsCropping": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/avatar-cropping#",
        "title": "Avatar Cropping",
        "type": "object",
        "properties": {
            "cropperWidth": {
                "type": "integer"
            },
            "cropperOffsetX": {
                "type": "integer"
            },
            "cropperOffsetY": {
                "type": "integer"
            },
            "url": {
                "type": "string"
            },
            "needsCropping": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "cropperWidth",
            "cropperOffsetX",
            "cropperOffsetY",
            "needsCropping"
        ]
    }
  • 状态500
    返回如果在临时化身转换为真正的化身出现错误
  • 状态404
    如果用户不存在返回

返回该可见在当前登录用户的所有化身。

请求
查询参数
参数 类型 描述
username

用户名

回复
  • 状态200 - 应用程序/ JSON
    返回包含头像列表为定制的系统头像地图
    {
        "system": [
            {
                "id": "1000",
                "owner": "fred",
                "isSystemAvatar": true,
                "isSelected": false,
                "isDeletable": false,
                "urls": {
                    "16x16": "http://localhost:8090/jira/secure/useravatar?size=xsmall&avatarId=10040",
                    "24x24": "http://localhost:8090/jira/secure/useravatar?size=small&avatarId=10040",
                    "32x32": "http://localhost:8090/jira/secure/useravatar?size=medium&avatarId=10040",
                    "48x48": "http://localhost:8090/jira/secure/useravatar?avatarId=10040"
                },
                "selected": false
            }
        ],
        "custom": [
            {
                "id": "1010",
                "owner": "andrew",
                "isSystemAvatar": false,
                "isSelected": false,
                "isDeletable": true,
                "urls": {
                    "16x16": "http://localhost:8090/jira/secure/useravatar?size=xsmall&avatarId=10080",
                    "24x24": "http://localhost:8090/jira/secure/useravatar?size=small&avatarId=10080",
                    "32x32": "http://localhost:8090/jira/secure/useravatar?size=medium&avatarId=10080",
                    "48x48": "http://localhost:8090/jira/secure/useravatar?avatarId=10080"
                },
                "selected": false
            }
        ]
    }
    架构
    {
        "type": "object",
        "patternProperties": {
            ".+": {
                "type": "array",
                "items": {
                    "title": "Avatar",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "owner": {
                            "type": "string"
                        },
                        "isSystemAvatar": {
                            "type": "boolean"
                        },
                        "isSelected": {
                            "type": "boolean"
                        },
                        "isDeletable": {
                            "type": "boolean"
                        },
                        "urls": {
                            "type": "object",
                            "patternProperties": {
                                "\\d\\dx\\d\\d": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        },
                        "selected": {
                            "type": "boolean"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "isSystemAvatar",
                        "isSelected",
                        "isDeletable",
                        "selected"
                    ]
                }
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态500
    如果返回在检索化身的列表时发生错误。
  • 状态404
    如果所请求的用户未找到返回。

返回给定用户的默认列。 管理员权限将被要求获得列比用户当前登录的其他用户。

请求
查询参数
参数 类型 描述
username

用户名

回复
  • 状态200 - 应用程序/ JSON
    返回列的列表进行配置给定用户
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-column-item#",
        "title": "List of Column Item",
        "type": "array",
        "items": {
            "title": "Column Item",
            "type": "object",
            "properties": {
                "label": {
                    "type": "string"
                },
                "value": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态401
    返回如果当前用户是不允许请求的列给定用户。
  • 状态500
    返回如果检索列配置发生了错误。
  • 状态404
    如果所请求的用户未找到返回。

设置为给定用户的默认列。 管理员权限将被要求获得列比用户当前登录的其他用户。

请求
回复
  • 状态200
    当列保存成功返回
  • 状态500
    返回如果检索列配置发生了错误。

重置默认列给定用户到系统默认值。 管理员权限将被要求获得列比用户当前登录的其他用户。

请求
查询参数
参数 类型 描述
username

用户名

回复
  • 状态401
    返回如果当前用户是不允许请求的列给定用户。
  • 状态500
    返回如果在重置列配置发生了错误。
  • 状态204
    当列复位成功返回

修改用户密码。

请求
查询参数
参数 类型 描述
username

用户名

key

用户密钥

{
    "password": "new password"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/password#",
    "title": "Password",
    "type": "object",
    "properties": {
        "password": {
            "type": "string"
        },
        "currentPassword": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态400
    返回如果请求是无效的。
  • 状态401
    返回,如果用户不被认证。
  • 状态204
    如果用户存在,并且调用者有权编辑它返回。
  • 状态403
    返回如果调用者没有权限更改用户密码。
  • 状态404
    返回如果调用者有权更改用户密码,但用户不存在。

返回与搜索字符串匹配和对项目或问题的所有规定权限活动用户的列表。
这个资源可以通过用户与项目或全球ADMIN或系统管理员权限ADMINISTER_PROJECT权限访问。

请求
查询参数
参数 类型 描述
username

用户名过滤器列表包括如果未指定的所有用户

permissions

逗号分隔的权限列表项目或问题返回的用户必须拥有,请参阅 权限 的JavaDoc所有可能的权限列表。

issueKey

对这一问题的关键问题为其返回的用户都有指定的权限。

projectKey

可选的项目项,以搜索与如果没有issueKey提供用户。

startAt INT

第一用户的索引返回(从0开始)

maxResults INT

用户的最大数量返回(默认为50)。 最大允许值为1000。如果指定的值比这个数字更高,搜索结果将被截断。

回复
  • 状态200 - 应用程序/ JSON
    返回JIRA用户JSON格式的完整表示。
    [
        {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        {
            "self": "http://www.example.com/jira/rest/api/2/user?username=andrew",
            "name": "andrew",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=andrew",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=andrew",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=andrew",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=andrew"
            },
            "displayName": "Andrew Anderson",
            "active": false
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-user#",
        "title": "List of User",
        "type": "array",
        "items": {
            "title": "User",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "expand": {
                    "type": "string"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        }
    }
  • 状态400
    如果没有提供项目或问题键或返回时,权限列表为空或包含无效的项
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态403
    如果当前用户不具有项目管理权限返回。
  • 状态404
    如果未找到所请求的问题或项目返回。

返回用户突出匹配查询的列表。 此资源不能被匿名访问。

请求
查询参数
参数 类型 描述
query

使用的字符串搜索用户名,姓名或电子邮件地址

maxResults INT

用户的最大数量返回(默认为50)。 最大允许值为1000。如果指定的值比这个数字更高,搜索结果将被截断。

showAvatar 布尔
exclude
回复
  • 状态200 - 应用程序/ JSON
    返回JIRA用户JSON格式的完整表示。
    {
        "users": [
            {
                "name": "fred",
                "key": "fred",
                "html": "fred@example.com",
                "displayName": "Fred Grumble",
                "avatarUrl": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred"
            }
        ],
        "total": 25,
        "header": "Showing 20 of 25 matching groups"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/user-picker-results#",
        "title": "User Picker Results",
        "type": "object",
        "properties": {
            "users": {
                "type": "array",
                "items": {
                    "title": "User Picker User",
                    "type": "object",
                    "properties": {
                        "name": {
                            "type": "string"
                        },
                        "key": {
                            "type": "string"
                        },
                        "html": {
                            "type": "string"
                        },
                        "displayName": {
                            "type": "string"
                        },
                        "avatarUrl": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "total": {
                "type": "integer"
            },
            "header": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态404
    如果所请求的用户未找到返回。

返回与搜索字符串匹配用户的列表。 此资源不能被匿名访问。

请求
查询参数
参数 类型 描述
username

使用的查询字符串来搜索用户名,姓名或电子邮件地址

startAt INT

第一用户的索引返回(从0开始)

maxResults INT

用户的最大数量返回(默认为50)。 最大允许值为1000。如果指定的值比这个数字更高,搜索结果将被截断。

includeActive 布尔

如果属实,那么活跃用户都包括在结果中(默认为true)

includeInactive 布尔

如果属实,那么不活动的用户都包括在结果中(默认为false)

回复
  • 状态200 - 应用程序/ JSON
    返回JIRA用户JSON格式的完整表示。
    [
        {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        {
            "self": "http://www.example.com/jira/rest/api/2/user?username=andrew",
            "name": "andrew",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=andrew",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=andrew",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=andrew",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=andrew"
            },
            "displayName": "Andrew Anderson",
            "active": false
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-user#",
        "title": "List of User",
        "type": "array",
        "items": {
            "title": "User",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "expand": {
                    "type": "string"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        }
    }
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态404
    如果所请求的用户未找到返回。

返回与搜索字符串匹配的活跃用户列表。 此资源不能被匿名访问并要求用户浏览全局权限。 鉴于问题的关键这一资源将提供匹配搜索字符串并有提供这个问题的浏览权限问题用户的列表。

请求
查询参数
参数 类型 描述
username

用户名过滤器,如果留空,没有用户回来

issueKey

对这一问题的关键问题正在编辑,我们需要找到可视用户提供。

projectKey

可选的项目项,以搜索与如果没有issueKey提供用户。

startAt INT

第一用户的索引返回(从0开始)

maxResults INT

用户的最大数量返回(默认为50)。 最大允许值为1000。如果指定的值比这个数字更高,搜索结果将被截断。

回复
  • 状态200 - 应用程序/ JSON
    返回JIRA用户JSON格式的完整表示。
    [
        {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": false
        },
        {
            "self": "http://www.example.com/jira/rest/api/2/user?username=andrew",
            "name": "andrew",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=andrew",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=andrew",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=andrew",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=andrew"
            },
            "displayName": "Andrew Anderson",
            "active": false
        }
    ]
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-user#",
        "title": "List of User",
        "type": "array",
        "items": {
            "title": "User",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "expand": {
                    "type": "string"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        }
    }
  • 状态400
    如果没有提供项目或问题键返回
  • 状态401
    返回如果当前用户没有通过验证。
  • 状态404
    如果未找到所请求的问题或项目返回。

API / 2 /用户/属性隐藏所有方法

返回由键或由ID标识的用户的所有属性的钥匙。

请求
查询参数
参数 类型 描述
userKey

其属性是要返回的用户的关键

username

其属性是要返回的用户的用户名

回复
  • 状态200 - 应用程序/ JSON
    如果用户被发现返回。
    {
        "keys": [
            {
                "self": "http://www.example.com/jira/rest/api/2/issue/EX-2/properties/issue.support",
                "key": "issue.support"
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-properties-keys#",
        "title": "Entity Properties Keys",
        "type": "object",
        "properties": {
            "keys": {
                "type": "array",
                "items": {
                    "title": "Entity Property Key",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string"
                        },
                        "key": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果用户密钥或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    返回如果主叫用户不具有权限浏览的用户。
  • 状态404
    如果返回给定键或ID的用户不存在,或者给定键的属性是找不到的。

移除按键式或由ID标识的用户属性。 THS用户删除属性是需要有权限来管理用户。

请求
查询参数
参数 类型 描述
userKey

其属性的用户的关键是要除去

username

其属性的用户的用户名是要除去

回复
  • 状态400
    返回如果用户密钥或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态204
    如果返回成功删除的用户属性。
  • 状态403
    如果返回调用用户没有权限编辑用户。
  • 状态404
    如果返回给定键或ID的用户不存在,或者给定键的属性是找不到的。

设置指定用户的属性值。

你可以使用这个资源来存储反对键或由ID标识的用户自定义数据。 谁存储数据的用户需要具有的权限来管理用户。

请求
查询参数
参数 类型 描述
userKey

其属性的用户的关键是要设定

username

其属性的用户的用户名是要设定

回复
  • 状态200
    返回如果用户属性被成功更新。
  • 状态201
    如果成功创建的用户属性返回。
  • 状态400
    返回如果用户密钥或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    返回如果主叫用户没有权限管理该用户。
  • 状态404
    如果与给定的密钥或ID的用户不存在返回。

返回与从由键或由id标识的用户给定键的属性的值。 谁检索的属性的用户需要有阅读权限的用户。

请求
查询参数
参数 类型 描述
userKey

其属性的用户的关键是要返回

username

其属性的用户的用户名是要返回

回复
  • 状态200 - 应用程序/ JSON
    如果用户属性被发现返回。
    {
        "key": "issue.support",
        "value": {
            "hipchat.room.id": "support-123",
            "support.time": "1m"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/entity-property#",
        "title": "Entity Property",
        "type": "object",
        "properties": {
            "key": {
                "type": "string"
            },
            "value": {}
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果用户密钥或ID无效。
  • 状态401
    返回如果调用用户没有通过验证。
  • 状态403
    返回如果主叫用户不具有权限浏览的用户。
  • 状态404
    如果返回给定键或ID的用户不存在,或者给定键的属性是找不到的。

API / 2 /版本隐藏所有方法

通过创建一个POST版本。

请求
{
    "description": "An excellent version",
    "name": "New Version 1",
    "archived": false,
    "released": true,
    "releaseDate": "2010-07-06",
    "userReleaseDate": "6/Jul/2010",
    "project": "PXA",
    "projectId": 10000
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/version#",
    "title": "Version",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "archived": {
            "type": "boolean"
        },
        "released": {
            "type": "boolean"
        },
        "overdue": {
            "type": "boolean"
        },
        "userStartDate": {
            "type": "string"
        },
        "userReleaseDate": {
            "type": "string"
        },
        "project": {
            "type": "string"
        },
        "projectId": {
            "type": "integer"
        },
        "moveUnfixedIssuesTo": {
            "type": "string",
            "format": "uri"
        },
        "operations": {
            "type": "array",
            "items": {
                "title": "Simple Link",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "styleClass": {
                        "type": "string"
                    },
                    "iconClass": {
                        "type": "string"
                    },
                    "label": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "href": {
                        "type": "string"
                    },
                    "weight": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false
            }
        },
        "remotelinks": {
            "type": "array",
            "items": {
                "title": "Remote Entity Link",
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "link": {}
                },
                "additionalProperties": false
            }
        }
    },
    "additionalProperties": false
}
回复
  • 状态201 - 应用程序/ JSON
    如果成功创建的版本返回。
    {
        "description": "An excellent version",
        "name": "New Version 1",
        "archived": false,
        "released": true,
        "releaseDate": "2010-07-06",
        "userReleaseDate": "6/Jul/2010",
        "project": "PXA",
        "projectId": 10000
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/version#",
        "title": "Version",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "archived": {
                "type": "boolean"
            },
            "released": {
                "type": "boolean"
            },
            "overdue": {
                "type": "boolean"
            },
            "userStartDate": {
                "type": "string"
            },
            "userReleaseDate": {
                "type": "string"
            },
            "project": {
                "type": "string"
            },
            "projectId": {
                "type": "integer"
            },
            "moveUnfixedIssuesTo": {
                "type": "string",
                "format": "uri"
            },
            "operations": {
                "type": "array",
                "items": {
                    "title": "Simple Link",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "styleClass": {
                            "type": "string"
                        },
                        "iconClass": {
                            "type": "string"
                        },
                        "label": {
                            "type": "string"
                        },
                        "title": {
                            "type": "string"
                        },
                        "href": {
                            "type": "string"
                        },
                        "weight": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "remotelinks": {
                "type": "array",
                "items": {
                    "title": "Remote Entity Link",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "name": {
                            "type": "string"
                        },
                        "link": {}
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态403
    返回如果当前身份验证的用户没有权限编辑的版本。
  • 状态404
    如果版本不存在或当前身份验证的用户没有权限查看它返回。

在一个项目中修改版本的序列。

此举版bean有2场的替代值对:

位置
绝对位置,其可以具有值“第一”,“上次”,“早期”或“后来”
一个版本后把这个版本。 值应为另一个版本的自链接

请求
{
    "after": "http://www.example.com/jira/rest/api/2/version/10000"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/version-move#",
    "title": "Version Move",
    "type": "object",
    "properties": {
        "after": {
            "type": "string",
            "format": "uri"
        },
        "position": {
            "type": "string",
            "enum": [
                "Earlier",
                "Later",
                "First",
                "Last"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    如果版本存在返回,目前已验证的用户有权限查看。 包含的版本完整表示感动。
    {
        "self": "http://www.example.com/jira/rest/api/2/version/10000",
        "id": "10000",
        "description": "An excellent version",
        "name": "New Version 1",
        "archived": false,
        "released": true,
        "releaseDate": "2010-07-06",
        "overdue": true,
        "userReleaseDate": "6/Jul/2010",
        "projectId": 10000
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/version#",
        "title": "Version",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "archived": {
                "type": "boolean"
            },
            "released": {
                "type": "boolean"
            },
            "overdue": {
                "type": "boolean"
            },
            "userStartDate": {
                "type": "string"
            },
            "userReleaseDate": {
                "type": "string"
            },
            "project": {
                "type": "string"
            },
            "projectId": {
                "type": "integer"
            },
            "moveUnfixedIssuesTo": {
                "type": "string",
                "format": "uri"
            },
            "operations": {
                "type": "array",
                "items": {
                    "title": "Simple Link",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "styleClass": {
                            "type": "string"
                        },
                        "iconClass": {
                            "type": "string"
                        },
                        "label": {
                            "type": "string"
                        },
                        "title": {
                            "type": "string"
                        },
                        "href": {
                            "type": "string"
                        },
                        "weight": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "remotelinks": {
                "type": "array",
                "items": {
                    "title": "Remote Entity Link",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "name": {
                            "type": "string"
                        },
                        "link": {}
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果以后移动版本的版本,或者目标不存在或当前身份验证的用户没有权限查看它返回。

返回一个项目版本。

请求
查询参数
参数 类型 描述
expand
回复
  • 状态200 - 应用程序/ JSON
    如果版本存在返回,目前已验证的用户有权限查看。 包含的版本完整表示。
    {
        "self": "http://www.example.com/jira/rest/api/2/version/10000",
        "id": "10000",
        "description": "An excellent version",
        "name": "New Version 1",
        "archived": false,
        "released": true,
        "releaseDate": "2010-07-06",
        "overdue": true,
        "userReleaseDate": "6/Jul/2010",
        "projectId": 10000
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/version#",
        "title": "Version",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "archived": {
                "type": "boolean"
            },
            "released": {
                "type": "boolean"
            },
            "overdue": {
                "type": "boolean"
            },
            "userStartDate": {
                "type": "string"
            },
            "userReleaseDate": {
                "type": "string"
            },
            "project": {
                "type": "string"
            },
            "projectId": {
                "type": "integer"
            },
            "moveUnfixedIssuesTo": {
                "type": "string",
                "format": "uri"
            },
            "operations": {
                "type": "array",
                "items": {
                    "title": "Simple Link",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "styleClass": {
                            "type": "string"
                        },
                        "iconClass": {
                            "type": "string"
                        },
                        "label": {
                            "type": "string"
                        },
                        "title": {
                            "type": "string"
                        },
                        "href": {
                            "type": "string"
                        },
                        "weight": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "remotelinks": {
                "type": "array",
                "items": {
                    "title": "Remote Entity Link",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "name": {
                            "type": "string"
                        },
                        "link": {}
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态404
    如果版本不存在或当前身份验证的用户没有权限查看它返回。

通过PUT修改版本。 目前在把任何领域将覆盖现有值。 为方便起见,如果一个字段不存在,它被忽略。

请求
{
    "self": "http://www.example.com/jira/rest/api/2/version/10000",
    "id": "10000",
    "description": "An excellent version",
    "name": "New Version 1",
    "archived": false,
    "released": true,
    "releaseDate": "2010-07-06",
    "overdue": true,
    "userReleaseDate": "6/Jul/2010",
    "projectId": 10000
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/version#",
    "title": "Version",
    "type": "object",
    "properties": {
        "id": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "archived": {
            "type": "boolean"
        },
        "released": {
            "type": "boolean"
        },
        "overdue": {
            "type": "boolean"
        },
        "userStartDate": {
            "type": "string"
        },
        "userReleaseDate": {
            "type": "string"
        },
        "project": {
            "type": "string"
        },
        "projectId": {
            "type": "integer"
        },
        "moveUnfixedIssuesTo": {
            "type": "string",
            "format": "uri"
        },
        "operations": {
            "type": "array",
            "items": {
                "title": "Simple Link",
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "styleClass": {
                        "type": "string"
                    },
                    "iconClass": {
                        "type": "string"
                    },
                    "label": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "href": {
                        "type": "string"
                    },
                    "weight": {
                        "type": "integer"
                    }
                },
                "additionalProperties": false
            }
        },
        "remotelinks": {
            "type": "array",
            "items": {
                "title": "Remote Entity Link",
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "link": {}
                },
                "additionalProperties": false
            }
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    如果版本存在返回,目前已验证的用户有权对其进行编辑。
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/version#",
        "title": "Version",
        "type": "object",
        "properties": {
            "expand": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "id": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "name": {
                "type": "string"
            },
            "archived": {
                "type": "boolean"
            },
            "released": {
                "type": "boolean"
            },
            "overdue": {
                "type": "boolean"
            },
            "userStartDate": {
                "type": "string"
            },
            "userReleaseDate": {
                "type": "string"
            },
            "project": {
                "type": "string"
            },
            "projectId": {
                "type": "integer"
            },
            "moveUnfixedIssuesTo": {
                "type": "string",
                "format": "uri"
            },
            "operations": {
                "type": "array",
                "items": {
                    "title": "Simple Link",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "styleClass": {
                            "type": "string"
                        },
                        "iconClass": {
                            "type": "string"
                        },
                        "label": {
                            "type": "string"
                        },
                        "title": {
                            "type": "string"
                        },
                        "href": {
                            "type": "string"
                        },
                        "weight": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "remotelinks": {
                "type": "array",
                "items": {
                    "title": "Remote Entity Link",
                    "type": "object",
                    "properties": {
                        "self": {
                            "type": "string",
                            "format": "uri"
                        },
                        "name": {
                            "type": "string"
                        },
                        "link": {}
                    },
                    "additionalProperties": false
                }
            }
        },
        "additionalProperties": false
    }
  • 状态403
    返回如果当前身份验证的用户没有权限编辑的版本。
  • 状态404
    如果版本不存在或当前身份验证的用户没有权限查看它返回。

删除项目版本。

请求
查询参数
参数 类型 描述
moveFixIssuesTo

该版本fixVersion置问题上如果删除的版本是修复版本,如果为null,则fixVersion被删除。

moveAffectedIssuesTo

该版本affectedVersion置问题上如果删除的版本是受影响的版本,如果为null,则affectedVersion被删除。

回复
  • 状态204
    如果返回的版本被成功删除。
  • 状态403
    返回如果当前身份验证的用户没有权限删除的版本。
  • 状态404
    如果版本不存在或当前身份验证的用户没有权限查看它返回。

合并版本

回复
  • 状态204
    如果返回的版本被成功删除。
  • 状态403
    返回如果当前身份验证的用户没有权限删除的版本。
  • 状态404
    如果版本不存在或当前身份验证的用户没有权限查看它返回。

返回包含了给定的版本在固定和受影响的问题数量的bean。

回复
  • 状态200 - 应用程序/ JSON
    如果版本存在返回,目前已验证的用户有权限查看。 包含固定的,影响这个版本中,自定义字段连接到这个版本问题计数。
    {
        "self": "http://www.example.com/jira/rest/api/2/version/10000",
        "issuesFixedCount": 23,
        "issuesAffectedCount": 101,
        "issueCountWithCustomFieldsShowingVersion": 54,
        "customFieldUsage": [
            {
                "fieldName": "Field1",
                "customFieldId": 10000,
                "issueCountWithVersionInCustomField": 2
            },
            {
                "fieldName": "Field2",
                "customFieldId": 10010,
                "issueCountWithVersionInCustomField": 3
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/version-issue-counts#",
        "title": "Version Issue Counts",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "issuesFixedCount": {
                "type": "integer"
            },
            "issuesAffectedCount": {
                "type": "integer"
            },
            "issueCountWithCustomFieldsShowingVersion": {
                "type": "integer"
            },
            "customFieldUsage": {
                "type": "array",
                "items": {
                    "title": "Version Usage In Custom Fields",
                    "type": "object",
                    "properties": {
                        "fieldName": {
                            "type": "string"
                        },
                        "customFieldId": {
                            "type": "integer"
                        },
                        "issueCountWithVersionInCustomField": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "customFieldId",
                        "issueCountWithVersionInCustomField"
                    ]
                }
            }
        },
        "additionalProperties": false,
        "required": [
            "issuesFixedCount",
            "issuesAffectedCount",
            "issueCountWithCustomFieldsShowingVersion"
        ]
    }
  • 状态404
    如果版本不存在或当前身份验证的用户没有权限查看它返回。

删除项目版本。

请求
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/delete-and-replace-version#",
    "title": "Delete And Replace Version",
    "type": "object"
}
回复
  • 状态204
    如果返回的版本被成功删除。
  • 状态403
    返回如果当前身份验证的用户没有权限删除的版本。
  • 状态404
    如果版本不存在或当前身份验证的用户没有权限查看它返回。

返回的未解决的问题数量为给定的版本

回复
  • 状态200 - 应用程序/ JSON
    如果版本存在返回,目前已验证的用户有权限查看。 包含在这个版本中尚未解决的问题数量。
    {
        "self": "http://www.example.com/jira/rest/api/2/version/10000",
        "issuesUnresolvedCount": 23
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/version-unresolved-issue-counts#",
        "title": "Version Unresolved Issue Counts",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "issuesUnresolvedCount": {
                "type": "integer"
            }
        },
        "additionalProperties": false,
        "required": [
            "issuesUnresolvedCount"
        ]
    }
  • 状态404
    如果版本不存在或当前身份验证的用户没有权限查看它返回。

返回与给定的版本ID相关联的远程版本的链接。

回复
  • 状态200 - 应用程序/ JSON
    如果版本存在返回,目前已验证的用户有权限查看,这是仅限于那些用户提供项目浏览权限。 包含远程版本的链接的完整表示。
    {
        "links": [
            {
                "self": "http://www.example.com/version/10000/AnotherGlobalId",
                "name": "Version 1",
                "link": {
                    "globalId": "AnotherGlobalId",
                    "myCustomLinkProperty": false,
                    "colors": [
                        "cyan",
                        "magenta",
                        "yellow"
                    ]
                }
            },
            {
                "self": "http://www.example.com/version/10000/SomeGlobalId",
                "name": "Version 1",
                "link": {
                    "globalId": "SomeGlobalId",
                    "myCustomLinkProperty": true,
                    "colors": [
                        "red",
                        "green",
                        "blue"
                    ]
                }
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/remote-entity-link#",
        "title": "Remote Entity Link",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "link": {}
        },
        "additionalProperties": false
    }
  • 状态404
    如果版本不存在或当前身份验证的用户没有权限查看它返回。

通过创建一个POST远程版本的链接。 链接的全球ID将从JSON有效载荷的是,如果提供的; 否则,它会产生。

请求
{
    "globalId": "SomeGlobalId",
    "myCustomLinkProperty": true,
    "colors": [
        "red",
        "green",
        "blue"
    ],
    "notes": [
        "Remote version links may take any well-formed JSON shape that is desired,",
        "provided that they fit within the maximum buffer size allowed,",
        "which is currently 32,768 characters."
    ]
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/string#",
    "title": "String",
    "type": "string"
}
回复
  • 状态201
    如果成功创建的版本返回。 该文件将没有内容,以及{@code地点:}头包含自身URI为新创建的链接。
    Returned if the remote version link is created or updated successfully.
     The document has no content, and a 
  • 状态400
    返回如果JSON有效载荷为空或畸形
  • 状态403
    返回如果当前身份验证的用户没有权限编辑的版本。
  • 状态404
    如果版本不存在或当前身份验证的用户没有权限查看它返回。

删除一个给定的版本ID的所有远程版本的链接。

回复
  • 状态204
    返回如果远程版本的链接被成功删除。
  • 状态403
    如果当前身份验证的用户不具有项目管理权限,因此不能删除远程链接的版本返回。
  • 状态404
    返回如果版本不存在,目前已验证的用户没有权限查看它,或者版本没有任何远程链接删除

表示远程版本链接休息子资源

回复
  • 状态200 - 应用程序/ JSON
    遥控器版本链接上的信息(或链接)
    {
        "self": "http://www.example.com/version/10000/SomeGlobalId",
        "name": "Version 1",
        "link": {
            "globalId": "SomeGlobalId",
            "myCustomLinkProperty": true,
            "colors": [
                "red",
                "green",
                "blue"
            ]
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/remote-entity-link#",
        "title": "Remote Entity Link",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "link": {}
        },
        "additionalProperties": false
    }
  • 状态404
    如果版本或远程版本链接不存在,或者如果用户不具有对于拥有该指定版本的项目的浏览权限返回

通过创建一个POST远程版本的链接。 链接的全球ID将从JSON有效载荷的是,如果提供的; 否则,它会产生。

请求
{
    "globalId": "SomeGlobalId",
    "myCustomLinkProperty": true,
    "colors": [
        "red",
        "green",
        "blue"
    ],
    "notes": [
        "Remote version links may take any well-formed JSON shape that is desired,",
        "provided that they fit within the maximum buffer size allowed,",
        "which is currently 32,768 characters."
    ]
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/string#",
    "title": "String",
    "type": "string"
}
回复
  • 状态201
    如果成功创建的版本返回。 该文件将没有内容,以及{@code地点:}头包含自身URI为新创建的链接。
    Returned if the remote version link is created or updated successfully.
     The document has no content, and a 
  • 状态400
    返回如果JSON有效载荷为空或畸形
  • 状态403
    返回如果当前身份验证的用户没有权限编辑的版本。
  • 状态404
    如果版本不存在或当前身份验证的用户没有权限查看它返回。

删除与给定的版本ID和全球ID特定的远程版本链接。

回复
  • 状态204
    返回如果远程版本的链接被成功删除。
  • 状态403
    如果当前身份验证的用户不具有项目管理权限,因此不能删除远程链接的版本返回。
  • 状态404
    返回如果版本不存在,目前已验证的用户没有权限查看,或版本没有一个链接给定的全局ID

返回给定的全球ID远程版本的链接。

请求
查询参数
参数 类型 描述
globalId

远程资源的全局ID被链接到的版本

回复
  • 状态200 - 应用程序/ JSON
    包含远程版本链接列表。 该用户没有权限查看的任何现有链接将被过滤掉。 用户必须拥有浏览权限项目以查看链接到它的版本。
    {
        "links": [
            {
                "self": "http://www.example.com/version/10000/SomeGlobalId",
                "name": "Version 1",
                "link": {
                    "globalId": "SomeGlobalId",
                    "myCustomLinkProperty": true,
                    "colors": [
                        "red",
                        "green",
                        "blue"
                    ]
                }
            },
            {
                "self": "http://www.example.com/version/10101/SomeGlobalId",
                "name": "Version 2",
                "link": {
                    "globalId": "SomeGlobalId"
                }
            }
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-remote-entity-link#",
        "title": "List of Remote Entity Link",
        "type": "array",
        "items": {
            "title": "Remote Entity Link",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "name": {
                    "type": "string"
                },
                "link": {}
            },
            "additionalProperties": false
        }
    }

API / 2 /工作流程隐藏所有方法

检索工作流程REST资源。

返回所有的工作流程。

请求
查询参数
参数 类型 描述
workflowName
回复
  • 状态200 - 应用程序/ JSON
    如果当前验证的用户具有行政许可返回。 包含所有工作流程的完整表示。
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow#",
        "title": "Workflow",
        "type": "object",
        "properties": {
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "lastModifiedDate": {
                "type": "string"
            },
            "lastModifiedUser": {
                "type": "string"
            },
            "steps": {
                "type": "integer"
            },
            "isDefault": {
                "type": "boolean"
            }
        },
        "additionalProperties": false,
        "required": [
            "isDefault"
        ]
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-workflow#",
        "title": "List of Workflow",
        "type": "array",
        "items": {
            "title": "Workflow",
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "description": {
                    "type": "string"
                },
                "lastModifiedDate": {
                    "type": "string"
                },
                "lastModifiedUser": {
                    "type": "string"
                },
                "steps": {
                    "type": "integer"
                },
                "isDefault": {
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "required": [
                "isDefault"
            ]
        }
    }
  • 状态401
    如果当前身份验证的用户不具有行政许可返回。

一个新的属性添加到一个过渡。 尝试添加已经存在失败的属性。

请求
查询参数
参数 类型 描述
key

该属性的名称的补充。

workflowName

使用工作流的名称。

workflowMode

工作流的类型来使用。 可以是“活”或“草稿”。

{
    "value": "createissue"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/property#",
    "title": "Property",
    "type": "object",
    "properties": {
        "key": {
            "type": "string"
        },
        "value": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    {
        "key": "jira.i18n.title",
        "value": "some.title",
        "id": "jira.i18n.title"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/property#",
        "title": "Property",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "key": {
                "type": "string"
            },
            "value": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果请求是无效的。
  • 状态403
    如果用户没有管理权限返回

更新/新属性添加到一个过渡。 试图更新不存在会导致在添加了新的属性的属性。

请求
查询参数
参数 类型 描述
key

该属性的名称的补充。

workflowName

使用工作流的名称。

workflowMode

工作流的类型来使用。 可以是“活”或“草稿”。

{
    "value": "createissue"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/property#",
    "title": "Property",
    "type": "object",
    "properties": {
        "key": {
            "type": "string"
        },
        "value": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    {
        "key": "jira.i18n.title",
        "value": "some.title",
        "id": "jira.i18n.title"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/property#",
        "title": "Property",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "key": {
                "type": "string"
            },
            "value": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
  • 状态400
    返回如果请求是无效的。
  • 状态403
    如果用户没有管理权限返回
  • 状态304
    返回如果没有变化的要求实际上是由(如更新属性珍惜它已经持有)。

从传递的工作流传递的过渡删除属性。 它不删除不存在的属性是一个错误。

请求
查询参数
参数 类型 描述
key

该属性的名称的补充。

workflowName

使用工作流的名称。

workflowMode

工作流的类型来使用。 可以是“活”或“草稿”。

回复
  • 状态200 - 应用程序/ JSON
  • 状态400
    返回如果请求是无效的。
  • 状态403
    如果用户没有管理权限返回
  • 状态304
    返回如果没有变化的要求实际上是由(例如试图删除一个不存在的属性)。

返回与转型相关的各种属性或属性。

请求
查询参数
参数 类型 描述
includeReservedKeys 布尔

根据某些键“JIRA”。 前缀是可编辑的,有些则不是。 为了将其设置为true,以包括在响应中不可编辑键。

key

查询属性键的名称。 可不放过查询返回的所有属性。

workflowName

使用工作流的名称。

workflowMode

工作流的类型来使用。 可以是“活”或“草稿”。

回复
  • 状态200 - 应用程序/ JSON
    {
        "key": "jira.i18n.title",
        "value": "some.title",
        "id": "jira.i18n.title"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/property#",
        "title": "Property",
        "type": "object",
        "properties": {
            "id": {
                "type": "string"
            },
            "key": {
                "type": "string"
            },
            "value": {
                "type": "string"
            }
        },
        "additionalProperties": false
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-property#",
        "title": "List of Property",
        "type": "array",
        "items": {
            "title": "Property",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string"
                },
                "key": {
                    "type": "string"
                },
                "value": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态403
    如果用户没有管理权限返回

API / 2 / workflowscheme 隐藏所有方法

创建一个新的工作流程方案。

正文包含新方案的表示。 假定不传递值被设置为默认值。

请求
{
    "name": "New Workflow Scheme Name",
    "description": "New Workflow Scheme Description",
    "defaultWorkflow": "DefaultWorkflowName",
    "issueTypeMappings": {
        "IsueTypeId": "WorkflowName"
    }
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
    "title": "Workflow Scheme",
    "type": "object",
    "properties": {
        "id": {
            "type": "integer"
        },
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "defaultWorkflow": {
            "type": "string"
        },
        "issueTypeMappings": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "originalDefaultWorkflow": {
            "type": "string"
        },
        "originalIssueTypeMappings": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "draft": {
            "type": "boolean"
        },
        "lastModifiedUser": {
            "title": "User",
            "type": "object",
            "properties": {
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        },
        "lastModified": {
            "type": "string"
        },
        "updateDraftIfNeeded": {
            "type": "boolean"
        },
        "issueTypes": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "title": "Issue Type",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "iconUrl": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "subtask": {
                            "type": "boolean"
                        },
                        "avatarId": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "subtask"
                    ]
                }
            },
            "additionalProperties": false
        }
    },
    "definitions": {
        "simple-list-wrapper": {
            "title": "Simple List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "title": "Group",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态201
    新创建的方案。
    {
        "id": 101010,
        "name": "Workflow Scheme One",
        "description": "Workflow Scheme One Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "draft": false,
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/101010"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。

返回请求的工作流程方案给调用者。

请求
查询参数
参数 类型 描述
returnDraftIfExists 布尔

默认值:

真正当指示计划的草案,如果存在,应该进行查询,而不是计划本身。

回复
  • 状态200 - 应用程序/ JSON
    如果该计划存在并且调用者有权查看它返回。
    {
        "id": 101010,
        "name": "Workflow Scheme One",
        "description": "Workflow Scheme One Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "draft": false,
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/101010"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果请求的方案不存在,则返回。

删除通过工作流程方案。

回复
  • 状态400
    返回如果请求的方案是积极的(即正在使用的JIRA)。
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态204
    如果该计划已被删除。
  • 状态404
    如果请求的方案不存在,则返回。

更新通过工作流程方案。

的请求的主体是工作流方案的表示。 假定不通过值来指示该领域没有任何变化。

传递表示可以有其updateDraftIfNeeded标志设置为true,表示该草案应创建和/或更新时,实际的方案不能进行编辑(例如,当正在使用的项目中的方案)。 未出现身体的值将不会被改变。

请求
{
    "id": 57585,
    "name": "Updated Workflow Scheme Name",
    "description": "Updated Workflow Scheme Name",
    "defaultWorkflow": "DefaultWorkflowName",
    "issueTypeMappings": {
        "IsueTypeId": "WorkflowName"
    },
    "updateDraftIfNeeded": false
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
    "title": "Workflow Scheme",
    "type": "object",
    "properties": {
        "id": {
            "type": "integer"
        },
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "defaultWorkflow": {
            "type": "string"
        },
        "issueTypeMappings": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "originalDefaultWorkflow": {
            "type": "string"
        },
        "originalIssueTypeMappings": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "draft": {
            "type": "boolean"
        },
        "lastModifiedUser": {
            "title": "User",
            "type": "object",
            "properties": {
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        },
        "lastModified": {
            "type": "string"
        },
        "updateDraftIfNeeded": {
            "type": "boolean"
        },
        "issueTypes": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "title": "Issue Type",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "iconUrl": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "subtask": {
                            "type": "boolean"
                        },
                        "avatarId": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "subtask"
                    ]
                }
            },
            "additionalProperties": false
        }
    },
    "definitions": {
        "simple-list-wrapper": {
            "title": "Simple List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "title": "Group",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    更新后的方案。
    {
        "id": 101010,
        "name": "Workflow Scheme One",
        "description": "Workflow Scheme One Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "draft": false,
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/101010"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果请求的方案不存在,则返回。

创建传递方案的草案。 该草案将成为母公司的状态的副本。

回复
  • 状态201
    新创建的方案。
    {
        "id": 17218781,
        "name": "Workflow Scheme Two",
        "description": "Workflow Scheme Two Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "originalDefaultWorkflow": "ParentsDefaultWorkflowName",
        "originalIssueTypeMappings": {
            "IssueTypeId": "WorkflowName2"
        },
        "draft": true,
        "lastModifiedUser": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "emailAddress": "fred@example.com",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": true,
            "timeZone": "Australia/Sydney",
            "groups": {
                "size": 3,
                "items": []
            },
            "applicationRoles": {
                "size": 1,
                "items": []
            }
        },
        "lastModified": "Today 12:45",
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。

取下通过工作流方案的默认工作流程。

请求
查询参数
参数 类型 描述
updateDraftIfNeeded 布尔

当真正将创建并返回一个草案时工作流程方案不能进行编辑(例如当其正在使用的一个项目)。

回复
  • 状态200
    返回成功。
    {
        "id": 101010,
        "name": "Workflow Scheme One",
        "description": "Workflow Scheme One Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "draft": false,
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/101010"
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果该方案不存在,则返回。

设置传递的工作流程方案的默认工作流程。

传递表示可以有其updateDraftIfNeeded标志设置为true,表示该草案应创建/更新时的实际方案不能进行编辑。

请求
{
    "workflow": "WorkflowName",
    "updateDraftIfNeeded": false
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/default#",
    "title": "Default",
    "type": "object",
    "properties": {
        "workflow": {
            "type": "string"
        },
        "updateDraftIfNeeded": {
            "type": "boolean"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    返回成功。
    {
        "id": 101010,
        "name": "Workflow Scheme One",
        "description": "Workflow Scheme One Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "draft": false,
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/101010"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果该方案不存在,则返回。

从工作流程传递计划返回默认的工作流程。

请求
查询参数
参数 类型 描述
returnDraftIfExists 布尔

默认值:

真正当指示计划的草案,如果存在,应该进行查询,而不是计划本身。

回复
  • 状态200
    {
        "workflow": "WorkflowName"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/default#",
        "title": "Default",
        "type": "object",
        "properties": {
            "workflow": {
                "type": "string"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    当工作流方案不存在,则返回。

返回请求的工作流程计划草案给调用者。

回复
  • 状态200 - 应用程序/ JSON
    如果该计划存在并且调用者有权查看它返回。
    {
        "id": 17218781,
        "name": "Workflow Scheme Two",
        "description": "Workflow Scheme Two Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "originalDefaultWorkflow": "ParentsDefaultWorkflowName",
        "originalIssueTypeMappings": {
            "IssueTypeId": "WorkflowName2"
        },
        "draft": true,
        "lastModifiedUser": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "emailAddress": "fred@example.com",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": true,
            "timeZone": "Australia/Sydney",
            "groups": {
                "size": 3,
                "items": []
            },
            "applicationRoles": {
                "size": 1,
                "items": []
            }
        },
        "lastModified": "Today 12:45",
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果请求的计划草案不存在返回。

删除通过工作流计划草案。

回复
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态204
    如果该计划已被删除。
  • 状态404
    如果请求的计划草案或父母方案不存在,则返回。

更新工作流计划草案。 如有必要,该草案将创建。

身是工作流方案的表示。 假定不通过值来指示该领域没有任何变化。

请求
{
    "id": 57585,
    "name": "Updated Workflow Scheme Name",
    "description": "Updated Workflow Scheme Name",
    "defaultWorkflow": "DefaultWorkflowName",
    "issueTypeMappings": {
        "IsueTypeId": "WorkflowName"
    },
    "updateDraftIfNeeded": false
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
    "title": "Workflow Scheme",
    "type": "object",
    "properties": {
        "id": {
            "type": "integer"
        },
        "name": {
            "type": "string"
        },
        "description": {
            "type": "string"
        },
        "defaultWorkflow": {
            "type": "string"
        },
        "issueTypeMappings": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "originalDefaultWorkflow": {
            "type": "string"
        },
        "originalIssueTypeMappings": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "draft": {
            "type": "boolean"
        },
        "lastModifiedUser": {
            "title": "User",
            "type": "object",
            "properties": {
                "key": {
                    "type": "string"
                },
                "name": {
                    "type": "string"
                },
                "emailAddress": {
                    "type": "string"
                },
                "avatarUrls": {
                    "type": "object",
                    "patternProperties": {
                        ".+": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "additionalProperties": false
                },
                "displayName": {
                    "type": "string"
                },
                "active": {
                    "type": "boolean"
                },
                "timeZone": {
                    "type": "string"
                },
                "locale": {
                    "type": "string"
                },
                "groups": {
                    "$ref": "#/definitions/simple-list-wrapper"
                },
                "applicationRoles": {
                    "$ref": "#/definitions/simple-list-wrapper"
                }
            },
            "additionalProperties": false,
            "required": [
                "active"
            ]
        },
        "lastModified": {
            "type": "string"
        },
        "updateDraftIfNeeded": {
            "type": "boolean"
        },
        "issueTypes": {
            "type": "object",
            "patternProperties": {
                ".+": {
                    "title": "Issue Type",
                    "type": "object",
                    "properties": {
                        "id": {
                            "type": "string"
                        },
                        "description": {
                            "type": "string"
                        },
                        "iconUrl": {
                            "type": "string"
                        },
                        "name": {
                            "type": "string"
                        },
                        "subtask": {
                            "type": "boolean"
                        },
                        "avatarId": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false,
                    "required": [
                        "subtask"
                    ]
                }
            },
            "additionalProperties": false
        }
    },
    "definitions": {
        "simple-list-wrapper": {
            "title": "Simple List Wrapper",
            "type": "object",
            "properties": {
                "size": {
                    "type": "integer"
                },
                "max-results": {
                    "type": "integer"
                },
                "items": {
                    "type": "array",
                    "items": {
                        "title": "Group",
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    }
                }
            },
            "additionalProperties": false,
            "required": [
                "size"
            ]
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    更新/创建方案。
    {
        "id": 17218781,
        "name": "Workflow Scheme Two",
        "description": "Workflow Scheme Two Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "originalDefaultWorkflow": "ParentsDefaultWorkflowName",
        "originalIssueTypeMappings": {
            "IssueTypeId": "WorkflowName2"
        },
        "draft": true,
        "lastModifiedUser": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "emailAddress": "fred@example.com",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": true,
            "timeZone": "Australia/Sydney",
            "groups": {
                "size": 3,
                "items": []
            },
            "applicationRoles": {
                "size": 1,
                "items": []
            }
        },
        "lastModified": "Today 12:45",
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果请求的方案不存在,则返回。

从工作流程传递计划草案给调用者返回默认的工作流程。

回复
  • 状态200
    {
        "workflow": "WorkflowName"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/default#",
        "title": "Default",
        "type": "object",
        "properties": {
            "workflow": {
                "type": "string"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    当工作流方案不存在,则返回。

取下通过工作流程草案方案的默认工作流程。

回复
  • 状态200
    返回成功。
    {
        "id": 17218781,
        "name": "Workflow Scheme Two",
        "description": "Workflow Scheme Two Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "originalDefaultWorkflow": "ParentsDefaultWorkflowName",
        "originalIssueTypeMappings": {
            "IssueTypeId": "WorkflowName2"
        },
        "draft": true,
        "lastModifiedUser": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "emailAddress": "fred@example.com",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": true,
            "timeZone": "Australia/Sydney",
            "groups": {
                "size": 3,
                "items": []
            },
            "applicationRoles": {
                "size": 1,
                "items": []
            }
        },
        "lastModified": "Today 12:45",
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果该方案不存在,则返回。

设置传递的工作流程草案方案的默认工作流程。

请求
{
    "workflow": "WorkflowName",
    "updateDraftIfNeeded": false
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/default#",
    "title": "Default",
    "type": "object",
    "properties": {
        "workflow": {
            "type": "string"
        },
        "updateDraftIfNeeded": {
            "type": "boolean"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    返回成功。
    {
        "id": 17218781,
        "name": "Workflow Scheme Two",
        "description": "Workflow Scheme Two Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "originalDefaultWorkflow": "ParentsDefaultWorkflowName",
        "originalIssueTypeMappings": {
            "IssueTypeId": "WorkflowName2"
        },
        "draft": true,
        "lastModifiedUser": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "emailAddress": "fred@example.com",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": true,
            "timeZone": "Australia/Sydney",
            "groups": {
                "size": 3,
                "items": []
            },
            "applicationRoles": {
                "size": 1,
                "items": []
            }
        },
        "lastModified": "Today 12:45",
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果该方案不存在,则返回。

返回传入的工作流程计划草案的问题类型的映射。

回复
  • 状态200 - 应用程序/ JSON
    返回成功。
    {
        "issueType": "IssueTypeId",
        "workflow": "WorkflowName"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-type-mapping#",
        "title": "Issue Type Mapping",
        "type": "object",
        "properties": {
            "issueType": {
                "type": "string"
            },
            "workflow": {
                "type": "string"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果任一要求计划或问题类型不存在返回。

取下计划草案中规定的问题类型的映射。

回复
  • 状态200
    返回成功。
    {
        "id": 17218781,
        "name": "Workflow Scheme Two",
        "description": "Workflow Scheme Two Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "originalDefaultWorkflow": "ParentsDefaultWorkflowName",
        "originalIssueTypeMappings": {
            "IssueTypeId": "WorkflowName2"
        },
        "draft": true,
        "lastModifiedUser": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "emailAddress": "fred@example.com",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": true,
            "timeZone": "Australia/Sydney",
            "groups": {
                "size": 3,
                "items": []
            },
            "applicationRoles": {
                "size": 1,
                "items": []
            }
        },
        "lastModified": "Today 12:45",
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果任一要求计划或问题类型不存在返回。

设置传递计划草案的问题类型的映射。

传递表示可以有其updateDraftIfNeeded标志设置为true,表示该草案应创建/更新时的实际方案不能进行编辑。

请求
{
    "issueType": "IssueTypeId",
    "workflow": "WorkflowName",
    "updateDraftIfNeeded": false
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/issue-type-mapping#",
    "title": "Issue Type Mapping",
    "type": "object",
    "properties": {
        "issueType": {
            "type": "string"
        },
        "workflow": {
            "type": "string"
        },
        "updateDraftIfNeeded": {
            "type": "boolean"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    返回成功。
    {
        "id": 17218781,
        "name": "Workflow Scheme Two",
        "description": "Workflow Scheme Two Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "originalDefaultWorkflow": "ParentsDefaultWorkflowName",
        "originalIssueTypeMappings": {
            "IssueTypeId": "WorkflowName2"
        },
        "draft": true,
        "lastModifiedUser": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "emailAddress": "fred@example.com",
            "avatarUrls": {
                "48x48": "http://www.example.com/jira/secure/useravatar?size=large&ownerId=fred",
                "24x24": "http://www.example.com/jira/secure/useravatar?size=small&ownerId=fred",
                "16x16": "http://www.example.com/jira/secure/useravatar?size=xsmall&ownerId=fred",
                "32x32": "http://www.example.com/jira/secure/useravatar?size=medium&ownerId=fred"
            },
            "displayName": "Fred F. User",
            "active": true,
            "timeZone": "Australia/Sydney",
            "groups": {
                "size": 3,
                "items": []
            },
            "applicationRoles": {
                "size": 1,
                "items": []
            }
        },
        "lastModified": "Today 12:45",
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果任一要求计划或问题类型不存在返回。

返回工作流程映射或请求的映射给调用者草案。

请求
查询参数
参数 类型 描述
workflowName

工作流程映射返回。 可以传递null返回所有的映射。 必须是一个有效的工作流程的名称。

回复
  • 状态200 - 应用程序/ JSON
    返回成功。
    {
        "workflow": "WorkflowName",
        "issueTypes": [
            "IssueTypeId",
            "IssueTypeId2"
        ],
        "defaultMapping": false
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-mapping#",
        "title": "Workflow Mapping",
        "type": "object",
        "properties": {
            "workflow": {
                "type": "string"
            },
            "issueTypes": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "defaultMapping": {
                "type": "boolean"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            }
        },
        "additionalProperties": false
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-workflow-mapping#",
        "title": "List of Workflow Mapping",
        "type": "array",
        "items": {
            "title": "Workflow Mapping",
            "type": "object",
            "properties": {
                "workflow": {
                    "type": "string"
                },
                "issueTypes": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "defaultMapping": {
                    "type": "boolean"
                },
                "updateDraftIfNeeded": {
                    "type": "boolean"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果任一要求计划或工作流程不存在返回。

删除从工作流程计划草案的通过工作流程。

请求
查询参数
参数 类型 描述
workflowName

删除的工作流的名称。

回复
  • 状态200
    删除了该流程的方案。
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果所请求的方案或工作流不存在退货。

更新计划草案,包括通过映射。

身是工作流映射的表示。 假定不通过值来指示该领域没有任何变化。

请求
查询参数
参数 类型 描述
workflowName

工作流映射的名称来更新。

{
    "workflow": "WorkflowName3",
    "issueTypes": [
        "IssueTypeId"
    ],
    "updateDraftIfNeeded": true
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/workflow-mapping#",
    "title": "Workflow Mapping",
    "type": "object",
    "properties": {
        "workflow": {
            "type": "string"
        },
        "issueTypes": {
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "defaultMapping": {
            "type": "boolean"
        },
        "updateDraftIfNeeded": {
            "type": "boolean"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    更新后的方案。
    {
        "id": 101010,
        "name": "Workflow Scheme One",
        "description": "Workflow Scheme One Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "draft": false,
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/101010"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。

返回传入的工作流程方案的问题类型的映射。

请求
查询参数
参数 类型 描述
returnDraftIfExists 布尔

默认值:

真正当指示计划的草案,如果存在,应该进行查询,而不是计划本身。

回复
  • 状态200 - 应用程序/ JSON
    返回成功。
    {
        "issueType": "IssueTypeId",
        "workflow": "WorkflowName"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/issue-type-mapping#",
        "title": "Issue Type Mapping",
        "type": "object",
        "properties": {
            "issueType": {
                "type": "string"
            },
            "workflow": {
                "type": "string"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果任一要求计划或问题类型不存在返回。

取下方案指定的问题类型的映射。

请求
查询参数
参数 类型 描述
updateDraftIfNeeded 布尔

当真正将创建并返回一个草案时工作流程方案不能进行编辑(例如当其正在使用的一个项目)。

回复
  • 状态200
    返回成功。
    {
        "id": 101010,
        "name": "Workflow Scheme One",
        "description": "Workflow Scheme One Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "draft": false,
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/101010"
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果任一要求计划或问题类型不存在返回。

设置传递方案中的问题类型的映射。

传递表示可以有其updateDraftIfNeeded标志设置为true,表示该草案应创建/更新时的实际方案不能进行编辑。

请求
{
    "issueType": "IssueTypeId",
    "workflow": "WorkflowName",
    "updateDraftIfNeeded": false
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/issue-type-mapping#",
    "title": "Issue Type Mapping",
    "type": "object",
    "properties": {
        "issueType": {
            "type": "string"
        },
        "workflow": {
            "type": "string"
        },
        "updateDraftIfNeeded": {
            "type": "boolean"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    返回成功。
    {
        "id": 101010,
        "name": "Workflow Scheme One",
        "description": "Workflow Scheme One Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "draft": false,
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/101010"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果任一要求计划或问题类型不存在返回。

返回给调用者的传递计划工作流程映射或请求的映射。

请求
查询参数
参数 类型 描述
workflowName

工作流程映射返回。 可以传递null返回所有的映射。 必须是一个有效的工作流程的名称。

returnDraftIfExists 布尔

默认值:

真正当指示计划的草案,如果存在,应该进行查询,而不是计划本身。

回复
  • 状态200 - 应用程序/ JSON
    返回成功。
    {
        "workflow": "WorkflowName",
        "issueTypes": [
            "IssueTypeId",
            "IssueTypeId2"
        ],
        "defaultMapping": false
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-mapping#",
        "title": "Workflow Mapping",
        "type": "object",
        "properties": {
            "workflow": {
                "type": "string"
            },
            "issueTypes": {
                "type": "array",
                "items": {
                    "type": "string"
                }
            },
            "defaultMapping": {
                "type": "boolean"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            }
        },
        "additionalProperties": false
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-workflow-mapping#",
        "title": "List of Workflow Mapping",
        "type": "array",
        "items": {
            "title": "Workflow Mapping",
            "type": "object",
            "properties": {
                "workflow": {
                    "type": "string"
                },
                "issueTypes": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "defaultMapping": {
                    "type": "boolean"
                },
                "updateDraftIfNeeded": {
                    "type": "boolean"
                }
            },
            "additionalProperties": false
        }
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果任一要求计划或工作流程不存在返回。

删除从工作流程方案通过工作流程。

请求
查询参数
参数 类型 描述
workflowName

删除的工作流的名称。

updateDraftIfNeeded 布尔

标志指示是否草案应创建如果需要删除从该计划的工作流程。

回复
  • 状态200
    删除了该流程的方案。
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。
  • 状态404
    如果所请求的方案或工作流不存在退货。

更新计划,包括通过映射。

身是工作流映射的表示。 假定不通过值来指示该领域没有任何变化。

传递表示可以有其updateDraftIfNeeded标志设置为true,表示该草案应创建/更新时的实际方案不能进行编辑。

请求
查询参数
参数 类型 描述
workflowName

工作流映射的名称来更新。

{
    "workflow": "WorkflowName3",
    "issueTypes": [
        "IssueTypeId"
    ],
    "updateDraftIfNeeded": true
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/workflow-mapping#",
    "title": "Workflow Mapping",
    "type": "object",
    "properties": {
        "workflow": {
            "type": "string"
        },
        "issueTypes": {
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "defaultMapping": {
            "type": "boolean"
        },
        "updateDraftIfNeeded": {
            "type": "boolean"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    更新后的方案。
    {
        "id": 101010,
        "name": "Workflow Scheme One",
        "description": "Workflow Scheme One Description",
        "defaultWorkflow": "DefaultWorkflowName",
        "issueTypeMappings": {
            "IsueTypeId2": "WorkflowName",
            "IsueTypeId": "WorkflowName"
        },
        "draft": false,
        "self": "http://www.example.com/jira/rest/api/2/workflowscheme/101010"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/workflow-scheme#",
        "title": "Workflow Scheme",
        "type": "object",
        "properties": {
            "id": {
                "type": "integer"
            },
            "name": {
                "type": "string"
            },
            "description": {
                "type": "string"
            },
            "defaultWorkflow": {
                "type": "string"
            },
            "issueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "originalDefaultWorkflow": {
                "type": "string"
            },
            "originalIssueTypeMappings": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "draft": {
                "type": "boolean"
            },
            "lastModifiedUser": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string",
                        "format": "uri"
                    },
                    "key": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string",
                                "format": "uri"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    },
                    "locale": {
                        "type": "string"
                    },
                    "groups": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "applicationRoles": {
                        "$ref": "#/definitions/simple-list-wrapper"
                    },
                    "expand": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            },
            "lastModified": {
                "type": "string"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "updateDraftIfNeeded": {
                "type": "boolean"
            },
            "issueTypes": {
                "type": "object",
                "patternProperties": {
                    ".+": {
                        "title": "Issue Type",
                        "type": "object",
                        "properties": {
                            "self": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            },
                            "description": {
                                "type": "string"
                            },
                            "iconUrl": {
                                "type": "string"
                            },
                            "name": {
                                "type": "string"
                            },
                            "subtask": {
                                "type": "boolean"
                            },
                            "avatarId": {
                                "type": "integer"
                            }
                        },
                        "additionalProperties": false,
                        "required": [
                            "subtask"
                        ]
                    }
                },
                "additionalProperties": false
            }
        },
        "definitions": {
            "simple-list-wrapper": {
                "title": "Simple List Wrapper",
                "type": "object",
                "properties": {
                    "size": {
                        "type": "integer"
                    },
                    "max-results": {
                        "type": "integer"
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "title": "Group",
                            "type": "object",
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "self": {
                                    "type": "string",
                                    "format": "uri"
                                }
                            },
                            "additionalProperties": false
                        }
                    }
                },
                "additionalProperties": false,
                "required": [
                    "size"
                ]
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回;如果不存在用户,或者如果用户没有输入一个websudo会话。

API / 2 /工作日志隐藏所有方法

返回worklogs ID,然后删除自定时间被删除worklogs的时间。 设置worklogs的回报率被限制在1000个元素。 这个API将不会返回最后一分钟时被删除worklogs。

请求
查询参数
参数 类型 描述
since

默认值: 0

日期时间在Unix时间戳格式从何时起将返回删除worklogs。

回复
  • 状态200 - 应用程序/ JSON
    返回的工作日志变化的JSON表示。
    {
        "values": [
            {
                "worklogId": 103,
                "updatedTime": 1438013671562
            },
            {
                "worklogId": 104,
                "updatedTime": 1438013672165
            },
            {
                "worklogId": 105,
                "updatedTime": 1438013693136
            }
        ],
        "since": 1438013671562,
        "until": 1438013693136,
        "self": "http://www.example.com/jira/worklog/updated/updated/deleted?since=1438013671136&since=1438013693136&since=1438013671136",
        "nextPage": "http://www.example.com/jira/worklog/updated/updated/deleted/deleted?since=1438013671136&since=1438013693136&since=1438013671136&since=1438013693136",
        "lastPage": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/worklog-changed-since#",
        "title": "Worklog Changed Since",
        "type": "object",
        "properties": {
            "values": {
                "type": "array",
                "items": {
                    "title": "Worklog Change",
                    "type": "object",
                    "properties": {
                        "worklogId": {
                            "type": "integer"
                        },
                        "updatedTime": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "since": {
                "type": "integer"
            },
            "until": {
                "type": "integer"
            },
            "isLastPage": {
                "type": "boolean"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "nextPage": {
                "type": "string",
                "format": "uri"
            }
        },
        "additionalProperties": false,
        "required": [
            "isLastPage"
        ]
    }

返回worklogs对于给定的工作日志的ID。 仅worklogs到主叫用户有权限,将包含在结果中。 设置worklogs的回报率被限制在1000个元素。

请求
{
    "ids": [
        1,
        2,
        5,
        10
    ]
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/worklog-ids-request#",
    "title": "Worklog Ids Request",
    "type": "object",
    "properties": {
        "ids": {
            "type": "array",
            "items": {
                "type": "integer"
            }
        }
    },
    "additionalProperties": false
}
回复
  • 状态200 - 应用程序/ JSON
    返回搜索结果的JSON表示。
    {
        "self": "http://www.example.com/jira/rest/api/2/issue/10010/worklog/10000",
        "author": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "updateAuthor": {
            "self": "http://www.example.com/jira/rest/api/2/user?username=fred",
            "name": "fred",
            "displayName": "Fred F. User",
            "active": false
        },
        "comment": "I did some work here.",
        "updated": "2016-09-06T09:48:12.832+0000",
        "visibility": {
            "type": "group",
            "value": "jira-developers"
        },
        "started": "2016-09-06T09:48:12.831+0000",
        "timeSpent": "3h 20m",
        "timeSpentSeconds": 12000,
        "id": "100028",
        "issueId": "10002"
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/list-of-worklog#",
        "title": "List of Worklog",
        "type": "array",
        "items": {
            "title": "Worklog",
            "type": "object",
            "properties": {
                "self": {
                    "type": "string",
                    "format": "uri"
                },
                "author": {
                    "$ref": "#/definitions/user"
                },
                "updateAuthor": {
                    "$ref": "#/definitions/user"
                },
                "comment": {
                    "type": "string"
                },
                "created": {
                    "type": "string"
                },
                "updated": {
                    "type": "string"
                },
                "visibility": {
                    "title": "Visibility",
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string",
                            "enum": [
                                "group",
                                "role"
                            ]
                        },
                        "value": {
                            "type": "string"
                        }
                    },
                    "additionalProperties": false
                },
                "started": {
                    "type": "string"
                },
                "timeSpent": {
                    "type": "string"
                },
                "timeSpentSeconds": {
                    "type": "integer"
                },
                "id": {
                    "type": "string"
                },
                "issueId": {
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "definitions": {
            "user": {
                "title": "User",
                "type": "object",
                "properties": {
                    "self": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "key": {
                        "type": "string"
                    },
                    "emailAddress": {
                        "type": "string"
                    },
                    "avatarUrls": {
                        "type": "object",
                        "patternProperties": {
                            ".+": {
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    },
                    "displayName": {
                        "type": "string"
                    },
                    "active": {
                        "type": "boolean"
                    },
                    "timeZone": {
                        "type": "string"
                    }
                },
                "additionalProperties": false,
                "required": [
                    "active"
                ]
            }
        }
    }
  • 状态400
    返回如果请求包含超过1000个ID或为null

返回worklogs worklogs的ID和更新的时间,因为给定的时间被更新。 设置worklogs的回报率被限制在1000个元素。 这个API将不会返回最后一分钟时更新worklogs。

请求
查询参数
参数 类型 描述
since

默认值: 0

日期时间在Unix时间戳格式从何时起将返回更新worklogs。

回复
  • 状态200 - 应用程序/ JSON
    返回的工作日志变化的JSON表示。
    {
        "values": [
            {
                "worklogId": 103,
                "updatedTime": 1438013671562
            },
            {
                "worklogId": 104,
                "updatedTime": 1438013672165
            },
            {
                "worklogId": 105,
                "updatedTime": 1438013693136
            }
        ],
        "since": 1438013671562,
        "until": 1438013693136,
        "self": "http://www.example.com/jira/worklog/updated?since=1438013671136",
        "nextPage": "http://www.example.com/jira/worklog/updated/updated?since=1438013671136&since=1438013693136",
        "lastPage": true
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/worklog-changed-since#",
        "title": "Worklog Changed Since",
        "type": "object",
        "properties": {
            "values": {
                "type": "array",
                "items": {
                    "title": "Worklog Change",
                    "type": "object",
                    "properties": {
                        "worklogId": {
                            "type": "integer"
                        },
                        "updatedTime": {
                            "type": "integer"
                        }
                    },
                    "additionalProperties": false
                }
            },
            "since": {
                "type": "integer"
            },
            "until": {
                "type": "integer"
            },
            "isLastPage": {
                "type": "boolean"
            },
            "self": {
                "type": "string",
                "format": "uri"
            },
            "nextPage": {
                "type": "string",
                "format": "uri"
            }
        },
        "additionalProperties": false,
        "required": [
            "isLastPage"
        ]
    }

认证/ 1 /会话隐藏所有方法

实现一个REST资源获取会话cookie。

创建在JIRA用户一个新的会话。 一旦会话已成功创建可用于通过传递相应的HTTP Cookie头访问任何JIRA的遥控器的API,也是web用户界面。

要注意的是通常最好使使用HTTP与REST API BASIC验证。 然而,该资源可以用于模仿JIRA的登录页面的行为(例如,以显示登录在错误的用户)。

请求
{
    "username": "fred",
    "password": "freds_password"
}
架构
{
    "id": "https://docs.atlassian.com/jira/REST/schema/auth-params#",
    "title": "Auth Params",
    "type": "object",
    "properties": {
        "username": {
            "type": "string"
        },
        "password": {
            "type": "string"
        }
    },
    "additionalProperties": false
}
回复
  • 状态200
    如果调用者进行身份验证返回有关调用者的会话信息。
    {
        "session": {
            "name": "JSESSIONID",
            "value": "12345678901234567890"
        },
        "loginInfo": {
            "failedLoginCount": 10,
            "loginCount": 127,
            "lastFailedLoginTime": "2016-09-06T09:48:10.855+0000",
            "previousLoginTime": "2016-09-06T09:48:10.855+0000"
        }
    }

    请注意,响应包含 Set-Cookie 的HTTP头 必须 由调用者兑现。 如果您使用的cookie识别HTTP客户端然后它会处理所有 Set-Cookie 自动头。 因为设置这是重要的 JSESSIONID 单独的cookie可能不足以用于认证工作。

    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/auth-success#",
        "title": "Auth Success",
        "type": "object",
        "properties": {
            "session": {
                "title": "Session Info",
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "value": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            },
            "loginInfo": {
                "title": "Login Info",
                "type": "object",
                "properties": {
                    "failedLoginCount": {
                        "type": "integer"
                    },
                    "loginCount": {
                        "type": "integer"
                    },
                    "lastFailedLoginTime": {
                        "type": "string"
                    },
                    "previousLoginTime": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态401
    如果登录由于无效的凭据失败时返回。
  • 状态403
    如果登录被拒绝因CAPTCHA要求,throtting,或任何其他理由退换。 在403状态码的情况下可能的是所提供的凭证是有效的,但不允许用户在这个时间点登陆。

注销当前用户从JIRA的,破坏现有的会话,如果有的话。

回复
  • 状态401
    返回如果调用者未经过身份验证。
  • 状态204
    返回如果用户已成功注销。

返回有关当前已验证用户的会话信息。 如果来电者未经过身份验证,他们会得到一个401 Unauthorized状态码。

回复
  • 状态200
    {
        "self": "http://www.example.com/jira/rest/api/2.0/user/fred",
        "name": "fred",
        "loginInfo": {
            "failedLoginCount": 10,
            "loginCount": 127,
            "lastFailedLoginTime": "2016-09-06T09:48:10.855+0000",
            "previousLoginTime": "2016-09-06T09:48:10.855+0000"
        }
    }
    架构
    {
        "id": "https://docs.atlassian.com/jira/REST/schema/current-user#",
        "title": "Current User",
        "type": "object",
        "properties": {
            "self": {
                "type": "string",
                "format": "uri"
            },
            "name": {
                "type": "string"
            },
            "loginInfo": {
                "title": "Login Info",
                "type": "object",
                "properties": {
                    "failedLoginCount": {
                        "type": "integer"
                    },
                    "loginCount": {
                        "type": "integer"
                    },
                    "lastFailedLoginTime": {
                        "type": "string"
                    },
                    "previousLoginTime": {
                        "type": "string"
                    }
                },
                "additionalProperties": false
            }
        },
        "additionalProperties": false
    }
  • 状态401
    返回如果调用者未经过身份验证。

认证/ 1 / websudo 隐藏所有方法

这种方法的无效任何当前WebSudo会话。

回复
  • 状态204
    如果没有发生错误返回